PROTOCOLS

監聽器

定義於 fuchsia.accessibility.virtualkeyboard/virtual_keyboard.fidl

提供通知感興趣的方 (「聆聽者」) 變更通知 開啟虛擬鍵盤狀態 (例如顯示設定)。

角色

這個通訊協定通常為：

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

附註

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

OnVisibilityChanged

通知 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 上叫用方法，藉此更新狀態。

附註

• 實作者可能會限制同時註冊的次數 允許 (例如：一次僅允許一項註冊)。
• 實作者應監控提供的 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