螢幕

screen 工具可讓代理安排瀏覽器式控制介面。它是具型別的版面配置與導覽介面，不是螢幕截圖擷取或瀏覽器自動化工具。

只有當來源用戶端宣告 ui-commands 功能時，才會公開此工具。工具執行時，仍須至少連線一個具備此功能的控制介面；否則閘道會傳回 UNAVAILABLE。

​

動作

動作	效果	選用輸入
split_right	將目標工作階段窗格向右分割	sessionKey（預設為目前的工作階段）
split_down	將目標工作階段窗格向下分割	sessionKey（預設為目前的工作階段）
close_pane	關閉目標工作階段窗格	sessionKey（預設為目前的工作階段）
focus	將焦點移至目標工作階段窗格	sessionKey（預設為目前的工作階段）
navigate	開啟目標工作階段	sessionKey（預設為目前的工作階段）
sidebar_show / sidebar_hide	顯示或隱藏主側邊欄	-
terminal_show / terminal_hide	顯示或隱藏操作員終端面板	顯示時使用 dock（bottom 或 right）
browser_show / browser_hide	顯示或隱藏瀏覽器面板	顯示時使用 dock（bottom 或 right）

命令成功後，閘道會廣播具型別的 ui.command 事件，接著傳回 { "ok": true }。

​

路由與安全性

通訊協定 v1 會刻意將命令傳送至每個已連線且宣告 ui-commands 的控制介面；它不會以單一瀏覽器分頁為目標。當同一位操作員開啟數個儀表板時，這一點很重要。

閘道 RPC 需要 operator.write。此工具只能變更顯示狀態：無法讀取像素、擷取螢幕截圖、點擊任意頁面內容，或繞過所選工作階段與操作員面板的權限。

​

相關內容

• 控制介面
• 閘道通訊協定
• 瀏覽器工具