Tools
螢幕
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。此工具只能變更呈現狀態：它無法讀取像素、擷取螢幕截圖、點擊任意頁面內容，或繞過所選工作階段與操作員面板的權限。
相關內容
Was this useful?
