Android无障碍宝典
Android江湖上一直流传着一部秘籍——Android无障碍宝典。传闻练成这部宝典，可在Android无障碍模式下，飞檐走壁，能人所不能。宝典分为三篇，分别是入门、进阶和高级，由浅入深，全面展示无障碍的基本方法及扩展应用。
Android应用无障碍化，目的是为视觉障碍或其他有障碍的用户提供更好的服务。在无障碍模式下，用户的操作方式与平常不同，比如：
- 选择（Hover）一个元素：单击
- 点击（Click）一个元素：双击
- 滚动：双指往上、下、左、右
- 选择上或下一个项目：单指往上、下、左、右
- 快速回到主画面：单指上滑+左滑
- 返回键：单指下滑+左滑
- 最近画面键：单指左滑+上滑
- 通知栏：单指右滑+下滑
此外，还需要理解在无障碍模式下“无障碍焦点”这个概念。如图1所示，界面上以绿色方框来表示目前获得无障碍焦点的View。拥有无障碍焦点的View，会被TalkBack服务识别，TalkBack会从View中取出相关的无障碍内容，然后提示给用户。
图1 无障碍焦点
有了对无障碍模式初步的了解，就可以正式开始学习如何为应用无障碍化。
入门篇
为View添加ContentDescription
UI上的可操作元素都应该添加上ContentDescription, 当此元素获得无障碍焦点时，TalkBack服务就取出View的提示语（contentDescription），并朗读出来。
添加ContentDescription有两种方法，第一种是通过在XML布局中设置android:contentDescripton属性，如：
<button android:id="”@+id/pause_button”" android:src="”@drawable/pause”" android:contentdescription="”@string/pause”/"><tton>
但是很多情况下，View的内容描述会根据不同情景需要而改变，比如CheckBox按钮是否被选中，以及ListView中item的内容描述等。这种则需要在代码中使用setContentDescription方法，如：
String contentDescription = "已选中 " + strValues[position];
label.setContentDescription(contentDescription);
设置无障碍焦点
UI上的元素，有的默认带有无障碍焦点，如Button、CheckBox等标准控件，有的如果不设置contentDescription是默认没有无障碍焦点。在开发应用过程中，还会遇到一些UI元素，是不希望它获取无障碍焦点的。以下方法可以改变元素的无障碍焦点：
public void setAccessibilityFocusable(View view, boolean focused){
if(android.os.Build.VERSION.SDK_INT >= 16){
if(focused){
ViewCompat.setImportantForAccessibility(view, ViewCompat.IMPORTANT_FOR_ACCESSIBILITY_YES);
}else{
ViewCompat.setImportantForAccessibility(view, ViewCompat.IMPORTANT_FOR_ACCESSIBILITY_NO);
}
}
}
IMPORTANT_FOR_ACCESSIBILITY_YES表示这个元素应该有无障碍焦点，会被TalkBack服务读出描述内容；IMPORTANT_FOR_ACCESSIBILITY_NO表示屏蔽元素的无障碍焦点，手指滑动遍历及触摸此元素，都不会获得无障碍焦点，TalkBack服务也不会读出其描述内容。
发出无障碍事件
IMPORTANT_FOR_ACCESSIBILITY_YES表示这个元素应该有无障碍焦点，会被TalkBack服务读出描述内容；IMPORTANT_FOR_ACCESSIBILITY_NO表示屏蔽元素的无障碍焦点，手指滑动遍历及触摸此元素，都不会获得无障碍焦点，TalkBack服务也不会读出其描述内容。
view.postDelayed(new Runnable() {
@Override
public void run() {
if(android.os.Build.VERSION.SDK_INT >= 14){
view.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_HOVER_ENTER);
}
}
},100);
这个方法是让View来自动发出被单击选中的无障碍事件，发出后，UI上的无障碍焦点则会马上赋给这个View，从而达到抢无障碍焦点的效果。再比如：
if(android.os.Build.VERSION.SDK_INT >= 16){
AccessibilityEvent event = AccessibilityEvent.obtain(AccessibilityEvent.TYPE_ANNOUNCEMENT);
event.setPackageName(view.getContext().getPackageName());
event.setClassName(view.getClass().getName());
event.setSource(view);
event.getText().add(desc);
view.getParent().requestSendAccessibilityEvent(view, event);
}
AccessibilityEvent.TYPE_ANNOUNCEMENT是代表元素需要TalkBack服务来读出描述内容。其中desc是描述内容，将它放到event的getText()中，然后请求View的父类来发出事件。
进阶篇
介绍AccessibilityDelegate
Android中View含有AccessibilityDelegate这个子类，它可被注册进View中，主要作用是为了增强对无障碍化的支持。
查看View的源码可发现，注册Accessibility Delegate方法很简单：
Public void setAccessibilityDelegate(AccessibilityDelegate delegate) {
mAccessibilityDelegate = delegate;
}
注册后，View对无障碍的处理，则会交给AccessibilityDelegate，如：
public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) {
if (mAccessibilityDelegate != null) {
mAccessibilityDelegate.onInitializeAccessibilityNodeInfo(this, info);
} else {
onInitializeAccessibilityNodeInfoInternal(info);
}
}
onInitializeAccessibilityNodeInfo是View源码中初始化无障碍节点信息的方法，从上面代码看出，当mAccessibilityDelegate是开发注册的AccessiblityDelegate时，则会执行AccessiblityDelegate中的onInitializeAccessibilityNodeInfo方法。再看看AccessibilityDelegate类中的onInitializeAccessibilityNodeInfo：
public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) {
host.onInitializeAccessibilityNodeInfoInternal(info);
}
Host是被注册AccessibilityDelegate的View，onInitializeAccessibilityNodeInfoInternal是View中真正初始化无障碍节点信息的方法。即是说，注册了AccessibilityDelegate并没有改变View原来对无障碍的操作，而是在这个操作之后增加了处理。
AccessibilityDelegate的应用
下面介绍下AccessibilityDelegate可以提供哪些无障碍应用，注册AccessibilityDelegate是在API 14以上才开放的接口，API 14以下如需使用，可以接入support v4包中的AccessibilityDelegateCompt。注册方法如下：
if (Build.VERSION.SDK_INT >= 14) {
View view = findViewById(R.id.view_id);
view.setAccessibilityDelegate(new AccessibilityDelegate() {
public void onInitializeAccessibilityNodeInfo(View host,
AccessibilityNodeInfo info) {
super.onInitializeAccessibilityNodeInfo(host, info);
// 对info做出扩展性支持
});
}
要对info做出扩展支持，还得先了解AccessibilityNodeInfo这个类。Android开发都知道，UI上的元素是通过View来实现，而AccessibilityNodeInfo则是存储View的无障碍信息（如contentDescription）及无障碍状态（如focusable、visiable、clickable等），同时它还肩负着TalkBack服务和View之间通讯的桥梁作用。如果要修改View的无障碍提示，比如修改View的类型提示，可以这样做：
if(android.os.Build.VERSION.SDK_INT >= 14){
view.setAccessibilityDelegate(new AccessibilityDelegate(){
@Override
public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) {
super.onInitializeAccessibilityNodeInfo(host, info);
if(contentDesc != null) {
info.setContentDescription(contentDesc);
}
info.setClassName(className);
}
});
}
className是类型名称，这里如果是Button.class.getName()，则TalkBack会对这个View读“XXX 按钮”，“XXX”是contentDescription，而“按钮”则是TalkBack服务添加的（如果是英文环境，则是“XXX button”）。使用上面的方法，可以为非按钮控件加上“按钮”的提示，方便无障碍用户识别UI上元素的作用，同时又不必把“按钮”提示强加入contentDescription中。除了修改AccessibilityNodeInfo外，使用AccessibilityDelegate还可以影响无障碍事件，如：
if (android.os.Build.VERSION.SDK_INT >= 14) {
view.setAccessibilityDelegate(new AccessibilityDelegate() {
@Override
public void sendAccessibilityEvent(View host, int eventType) {
// 弹出Popup后，不自动读各项内容
if (eventType != AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED) {
super.sendAccessibilityEvent(host, eventType);
}
}
});
}
无障碍模式下，弹出Dialog，则会把Dialog中的所有元素都读一遍。这个方法可以把弹起窗口的无障碍事件拦截，Dialog弹起就不会再自动读各项内容。
高级篇
有了AccessibilityDelegate这把利器之后，开发可以轻松对应Android中大部分的无障碍化，但是如果想要做到游刃有余，还得深造更高级的功夫——自定义View无障碍化。
应用开发过程中，总会需要自定义View来实现特殊的UI效果，当一个自定义View中包含多种UI元素时，无障碍模式下并不能区分包含的多种UI元素，而只为自定义View添加一个大无障碍焦点。如图2所示。
图2 自定义View只有一个大无障碍焦点
图中只有一个大无障碍焦点，因为这是一个View，里面的文字及蓝色的矩形都是绘制出来的。
@Override
public void onDraw(Canvas c) {
super.onDraw(c);
if (mTitle != null) {
drawTitle(c);
}
for (int i = 0; i < mSize; i++) {
drawBarAtIndex(c, i);
}
drawAxisY(c);
}
代码中绘制出来的元素不可被TalkBack识别出来，所以开发需要多做一步，对自定义View无障碍化。这里将介绍如何通过官方提供的ExploreByTouchHelper来实现。
图3 自定义View内元素获得无障碍焦点
图3是使用ExploreByTouchHelper实现的最终效果，每一个小矩形都能获取到无障碍焦点，且可以进行选中高亮。实现ExploreByTouchHelper需要五步。
第一步，委托处理无障碍。
public class BarGraphView extends View {
private final BarGraphAccessHelper mBarGraphAccessHelper;
public BarGraphView(Context context, AttributeSet attrs, int defStyle) {
super(context, attrs, defStyle);
...
mBarGraphAccessHelper = new BarGraphAccessHelper(this);
ViewCompat.setAccessibilityDelegate(this, mBarGraphAccessHelper);
}
@Override
public boolean dispatchHoverEvent(MotionEvent event) {
if ((mBarGraphAccessHelper != null)
&& mBarGraphAccessHelper.dispatchHoverEvent(event)) {
return true;
}
return super.dispatchHoverEvent(event);
}
}
mBarGraphAccessHelper继承ExploreBy TouchHelper，可通过注册AccessibilityDelegate的方式来注册给自定义BarGraphView，同时让mBarGraphAccessHelper来处理Hover事件（无障碍模式下的点击）的分发。
第二步，标记无障碍虚拟节点ID。
private class BarGraphAccessHelper extends ExploreByTouchHelper {
private final Rect mTempParentBounds = new Rect();
public BarGraphAccessHelper(View parentView) {
super(parentView);
}
@Override
protected int getVirtualViewIdAt(float x, float y) {
final int index = getBarIndexAt(x, y);
if (index >= 0) {
return index;
}
return ExploreByTouchHelper.INVALID_ID;
}
@Override
protected void getVisibleVirtualViewIds(List<integer> virtualViewIds) {
final int count = getBarCount();
for (int index = 0; index < count; index++) {
virtualViewIds.add(index);
}
}
}
getVirtualViewIdAt和getVisibleVirtualViewIds都是ExploreByTouchHelper类需要实现的方法，分别代表获取虚拟无障碍节点的id以及设置虚拟无障碍节点的id。由于自定义View里的元素非继承于View，如要在无障碍模式下被识别，则需要构造一个虚拟无障碍节点。构造方法已封装到ExploreByTouchHelper里，开发只需要告诉ExploreByTouchHelper有哪些虚拟无障碍节点的id即可。无障碍节点id需要满足以下条件：id是一个接一个的，稳定且为非负整数。设置好无障碍虚拟节点id后，根据用户操作UI上的xy坐标，取得对应的无障碍虚拟节点id，通过getVirtualViewIdAt方法告诉ExploreByTouchHelper类。
第三步，填充无障碍节点的属性。
private class BarGraphAccessHelper extends ExploreByTouchHelper {
...
private CharSequence getDescriptionForIndex(int index) {
final int value = getBarValue(index);
final int templateRes = ((mHighlightedIndex == index) ?
R.string.bar_desc_highlight : R.string.bar_desc);
return getContext().getString(templateRes, index, value);
}
@Override
protected void populateEventForVirtualViewId(int virtualViewId, AccessibilityEvent event) {
final CharSequence desc = getDescriptionForIndex(virtualViewId);
event.setContentDescription(desc);
}
@Override
protected void populateNodeForVirtualViewId(
int virtualViewId, AccessibilityNodeInfoCompat node) {
final CharSequence desc = getDescriptionForIndex(virtualViewId);
node.setContentDescription(desc);
node.addAction(AccessibilityNodeInfoCompat.ACTION_CLICK);
final Rect bounds = getBoundsForIndex(virtualViewId, mTempParentBounds);
node.setBoundsInParent(bounds);
}
}
构造了虚拟无障碍节点后，便可以往节点里塞无障碍信息。populateEventForVirtualViewId是将无障碍信息填入无障碍事件中。populateNodeForVirtualViewId是初始化每个虚拟无障碍节点，设置contentDescription，注册所需要处理的Action，以及设置无障碍焦点的边框。setBoundsInParent一定要设置有效的边框，否则会导致虚拟无障碍节点无法获取无障碍焦点。
第四步，提供用户无障碍交互支持。
private class BarGraphAccessHelper extends ExploreByTouchHelper {
...
@Override
protected boolean performActionForVirtualViewId(
int virtualViewId, int action, Bundle arguments) {
switch (action) {
case AccessibilityNodeInfoCompat.ACTION_CLICK:
onBarClicked(virtualViewId);
return true;
}
return false;
}
}
private void onBarClicked(int index) {
setSelection(index);
if (mBarGraphAccessHelper != null) {
mBarGraphAccessHelper.sendEventForVirtualViewId(
index, AccessibilityEvent.TYPE_VIEW_CLICKED);
}
}
小矩形点击后是会被选中且高亮的，在performActionForVirtualViewId中实现对应的点击事件处理。经过这四步，自定义View就可以完美支持无障碍化了！
可以看出，ExploreByTouchHelper简化了虚拟节点层次结构的构造，封装AccessibilityNodeProvider的实现，更完善的控制Hover事件、无障碍事件。有了它，Android无障碍化再也不是难题。
Android无障碍化宝典的内容就介绍到此，在实际开发中，遇到的无障碍化问题都比较细小和琐碎，希望以上介绍能提供一点帮助。很多Android开发以为无障碍化就是为控件加上ContentDescription，其实还有空描述、混乱焦点、焦点顺序、描述准确性等地方需要注意和优化。只有用心、持续地改进和优化，才能做出真正无障碍的产品。