协议

监听器

在 fuchsia.accessibility.virtualkeyboard/virtual_keyboard.fidl 中定义

提供有关虚拟键盘状态（例如可见性）变化的通知功能（“监听器”）。

角色

此协议通常为：

• 由实现无障碍功能的平台组件实现。 例如，a11y_manager。
• 由提供 GUI 功能用于文本输入的组件使用。

备注

当此协议的使用方发现通道已关闭时，它（协议使用方）应重试 Registry.Register()，并应用后退逻辑以避免紧密循环。

OnVisibilityChanged

通知 Listener 键盘可见性的变化。

此协议的使用方应等待每个调用得到确认，然后再进行再次调用，以避免将大量更新加入队列。

请求

名称	类型
updated_visibility	bool

响应

<EMPTY>

注册类型

在 fuchsia.accessibility.virtualkeyboard/virtual_keyboard.fidl 中定义

提供注册虚拟键盘的功能。

此协议用于将 Listener 绑定到 View（通过 ViewRef）。例如，该绑定允许无障碍子系统确定与 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