通訊協定

監聽器

定義於 fuchsia.accessibility.virtualKeyboard/virtual_Keyboard.fidl

提供將虛擬鍵盤狀態 (例如顯示設定) 變更的感興趣的一方 (「監聽者」) 告知。

角色

這個通訊協定通常為：

• 由實作無障礙功能的平台元件實作。例如 a11y_manager。
• 由提供 GUI 預設文字輸入用途的元件消耗。

Notes

當這個通訊協定的消費者發現管道已關閉時，(通訊協定取用者) 應重試 Registry.Register()，套用輪詢邏輯以避免過度迴圈。

可視的瀏覽權限

通知鍵盤瀏覽權限變更的 Listener。

此通訊協定的消費者應等到再次呼叫後再確認一次呼叫，以避免將大量更新排入佇列。

要求

姓名	類型
updated_visibility	bool

回應

<EMPTY>

登錄檔

定義於 fuchsia.accessibility.virtualKeyboard/virtual_Keyboard.fidl

提供註冊虛擬鍵盤的功能。

此通訊協定已存在，透過 ViewRef 繫結 Listener 至 View。繫結可以允許 (例如無障礙子系統) 判斷是否與 View 的互動會導致焦點轉移。

角色

這個通訊協定通常為：

• 由實作無障礙功能的平台元件實作。例如 a11y_manager。
• 由提供 GUI 預設文字輸入用途的元件消耗。

註冊

將 view_ref 參照的 View 註冊為包含虛擬鍵盤的 View。

在 View 中發現虛擬鍵盤是否存在，可能會動態變更。

• 初始狀態以 is_visible 表示。
• Registry 消費者會在提供的 server_end:Listener 上叫用方法，藉此更新狀態。

Notes

• 實作者可能會限制同時進行的註冊數 (例如僅允許一次註冊)。
• 實作人員應監控指定的 ViewRef 信號，以取得 ZX_EVENTPAIR_PEER_CLOSED 信號 (請參閱 fuchsia.ui.views.ViewRefControl 的說明文件)。
• 如果要求超過同步註冊上限，或是 ViewRef 收到 ZX_EVENTPAIR_PEER_CLOSED 時，實作人員應丟棄 listener。

要求

姓名	類型
view_ref	fuchsia.ui.views/ViewRef
is_visible	bool
listener	server_end<Listener>