虽然许多 Android TV 应用都是使用原生 Android 组件构建的,但考虑第三方框架或组件的无障碍功能也同样重要,尤其是在使用自定义视图时。
直接与 OpenGL 或 Canvas 交互的自定义视图组件可能无法与 Talkback 和 Switch Access 等无障碍服务良好配合。
请考虑开启 Talkback 时可能出现的一些问题
- 无障碍焦点(绿色矩形)可能会在您的应用中消失。
- 无障碍焦点可能会选中整个屏幕的边界。
- 无障碍焦点可能无法移动。
- 方向键上的四个方向键可能无效,即使您的代码正在处理它们。
如果您在应用中观察到任何这些问题,请检查您的应用是否将其 AccessibilityNodeInfo
树暴露给无障碍服务。
本指南的其余部分提供了一些解决这些问题的方案和最佳实践。
方向键事件被无障碍服务消耗
此问题的根本原因是按键事件被无障碍服务消耗。
图 1. 描绘了 Talkback 开启和关闭时系统如何运行的图表。
如图 1 所示,当 Talkback 开启时,方向键事件不会传递给开发者定义的D-pad 处理程序。相反,无障碍服务会接收按键事件,以便它们可以移动无障碍焦点。由于自定义 Android 组件默认不向无障碍服务暴露其在屏幕上的位置信息,因此无障碍服务无法移动无障碍焦点来突出显示它们。
其他无障碍服务也受到类似影响:使用 Switch Access 时,方向键事件也可能被消耗。
由于方向键事件被提交到无障碍服务,并且该服务不知道自定义视图中的 UI 组件在哪里,因此您必须为应用实现 AccessibilityNodeInfo
才能正确转发按键事件。
向无障碍服务暴露信息
为了向无障碍服务提供关于自定义视图位置和描述的足够信息,请实现 AccessibilityNodeInfo
以暴露每个组件的详细信息。为了定义视图的逻辑关系,以便无障碍服务可以管理焦点,请实现 ExploreByTouchHelper
并使用 ViewCompat.setAccessibilityDelegate(View, AccessibilityDelegateCompat)
为自定义视图进行设置。
在实现 ExploreByTouchHelper
时,重写其四个抽象方法
Kotlin
// Return the virtual view ID whose view is covered by the input point (x, y). protected fun getVirtualViewAt(x: Float, y: Float): Int // Fill the virtual view ID list into the input parameter virtualViewIds. protected fun getVisibleVirtualViews(virtualViewIds: List<Int>) // For the view whose virtualViewId is the input virtualViewId, populate the // accessibility node information into the AccessibilityNodeInfoCompat parameter. protected fun onPopulateNodeForVirtualView(virtualViewId: Int, @NonNull node: AccessibilityNodeInfoCompat) // Set the accessibility handling when perform action. protected fun onPerformActionForVirtualView(virtualViewId: Int, action: Int, @Nullable arguments: Bundle): Boolean
Java
// Return the virtual view ID whose view is covered by the input point (x, y). protected int getVirtualViewAt(float x, float y) // Fill the virtual view ID list into the input parameter virtualViewIds. protected void getVisibleVirtualViews(List<Integer> virtualViewIds) // For the view whose virtualViewId is the input virtualViewId, populate the // accessibility node information into the AccessibilityNodeInfoCompat parameter. protected void onPopulateNodeForVirtualView(int virtualViewId, @NonNull AccessibilityNodeInfoCompat node) // Set the accessibility handling when perform action. protected boolean onPerformActionForVirtualView(int virtualViewId, int action, @Nullable Bundle arguments)
如需了解更多详细信息,请观看Google I/O 2013 - 在 Android 上启用盲人和低视力无障碍功能,或阅读更多关于填充无障碍事件的信息。
最佳实践
必填:
AccessibilityNodeInfo.getBoundsInScreen()
必须定义组件的位置。必填:
AccessibilityNodeInfo.setVisibleToUser()
必须反映组件的可见性。必填:
AccessibilityNodeInfo.getContentDescription()
必须指定 Talkback 要播报的内容描述。指定
AccessibilityNodeInfo.setClassName()
,以便服务可以区分组件类型。在实现
performAction()
时,使用相应的AccessibilityEvent
反映操作。要实现更多操作类型,例如
ACTION_CLICK
,请使用performAction()
中相应的逻辑调用AccessibilityNodeInfo.addAction(ACTION_CLICK)
。适用时,为
setFocusable()
、setClickable()
、setScrollable()
和类似方法反映组件状态。查看
AccessibilityNodeInfo
的文档,以确定无障碍服务可以更好地与您的组件交互的其他方式。
示例
请参考Android TV 的自定义视图无障碍功能示例,了解如何向使用自定义视图的应用添加无障碍支持的最佳实践。