Android无障碍适配指南

前言：Android 应用的目标应该是让所有人都可以使用，包括有无障碍功能需求的人士。

有视觉障碍、色盲、视觉障碍、精细动作失能、认知障碍以及很多其他残疾的人员在日常生活中使用 Android 设备来完成各项任务。如果您能够在开发应用时考虑无障碍功能，那么您便可以改善用户体验，尤其是对于具有这些障碍和其他无障碍功能需求的用户来说。

在日常工作来说，对于一些系统性要求的公司，也是作为必须适配项之一。

1.启用焦点导航

Android提供了几个API让开发者决定用户界面控件是否可聚焦，甚至请求给控件赋予焦点：

• setFocusable()
• isFocusable()
• requestFocus()

如果视图不是默认聚焦，可以在布局文件中设置[android:focusable]
(http://developer.android.com/reference/android/view/View.html#attr_android:focusable)属性为true，或者调用setFocusable()方法让视图可聚焦。

2.基本的Android无障碍适配－contentDescription

1. 对于Android的基础组件ImageButton ImageView CheckBox等，只需要简单的在xml中设置 android:contentDescription="xx"属性或代码中动态设置view.setContentDescription("xx")即可。
2. 对于EditText区域，提供android:hint属性代替内容描述，文本区域为空的时候此属性帮助用户理解应该输入什么样的内容。当文本区域填充上内容，TalkBack将会读出输入的文本，而不会读出提示文本。
3. TextView或者继承至其的控件,如果contentDescription属性的值为空,无障碍服务会获取text属性的文本信息作为语音提示。
4. 一般情况下，如果无障碍服务说明的是 ViewGroup，则会将来自其子 View 的内容标签合并在一起。要抑制此行为，并指明您希望为该项及其不可聚焦的子 View 提供自己的说明，请在 ViewGroup 上设置 contentDescription。比如有一个展示型卡片，不做任何设置时，可能实际无障碍自动播报的顺序或播报的内容和预期不符合，可以format需要播报的内容，给最外层view整体设置contentDescritpion。
5. 对于一个不想让无障碍播报内容的view 　想要移除其焦点，可以设置其 android:importantForAccessibility="no";默认为yes
6. 希望一个view获取talkback的焦点，可以使用方法view.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);

3.复杂view的无障碍适配

对于基础组件，设置contentDescritpion就可以达到目标，那对于我们自定义的复杂view（比如日历的月盘，chart 柱状图等）来说，又该如何交互与播报呢？
总的来说，通过在自定义view里设置 ViewCompat.setAccessibilityDelegate(this, accessibilityDelegate);　扩展各个无障碍方法，实现自定义的无障碍。

• 一个小小例子　 AccessibilityDelegateSupportActivity.java
  onPopulateAccessibilityEvent()方法可专门用来为事件添加或修改文本内容，这些信息会被如TalkBack的无障碍服务转化为音频反馈。
  onInitializeAccessibilityNodeInfo()方法填充AccessibilityNodeInfo对象，视图层次在接收此事件后生成无障碍事件，无障碍服务使用AccessibilityNodeInfo对象访问该视图层次，获得更多的上下文信息并为用户提供合适的反馈。

• 一个详细讲的demo样例：
  这是一个 柱状图　横坐标代表的是24小时，纵轴是一些数据的展示，可忽略。现在的需求是在用户无障碍播报时可选中每小时对应的柱子，播报当前小时以及该小时的具体内容。如果不做任何限制，当前是不会有焦点到这个自定义的柱子上的。
  

  图表示例
  无障碍详情

附上关键代码

public class DayColumnChart extends View {
 private MyAccessHelper mAccessHelper;//无障碍代理
private List<DayColumnData> mColumnData;//每小时对应的数据
    public DayColumnChart(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
        super(context, attrs, defStyleAttr, defStyleRes);
        init();
    }
....
....
    private void init() {
        mAccessHelper = new MyAccessHelper(this);
        ViewCompat.setAccessibilityDelegate(this, mAccessHelper);
    }
....
....
    @Override
    public boolean dispatchHoverEvent(MotionEvent event) {
        return mAccessHelper.dispatchHoverEvent(event) || super.dispatchHoverEvent(event);
    }
}
 private class MyAccessHelper extends ExploreByTouchHelper {

        private Rect mAccessRect;

        /**
         * Constructs a new helper that can expose a virtual view hierarchy for the specified host
         * view.
         *
         * @param host view whose virtual view hierarchy is exposed by this helper
         */
        MyAccessHelper(@NonNull View host) {
            super(host);
            mAccessRect = new Rect();
        }

        @Override
        protected int getVirtualViewAt(float x, float y) {
            checkSelectIndex(x, y);
            return mSelectIndex;
        }

        @Override
        protected void getVisibleVirtualViews(List<Integer> virtualViewIds) {
            if (!ArrayUtils.isEmpty(mColumnData)) {
                for (final DayColumnData columnDatum : mColumnData) {
                    virtualViewIds.add(columnDatum.getIndex());
                }
            }
        }

        @Override
        protected void onPopulateNodeForVirtualView(int virtualViewId,
                @NonNull AccessibilityNodeInfoCompat node) {
            if (ArrayUtils.isEmpty(mColumnData) || getData(mSelectIndex) == null) {
                mAccessRect.setEmpty();
                node.setBoundsInParent(mAccessRect);
                node.setEnabled(false);
                node.setContentDescription("");
                return;
            }
            DayColumnData dayColumnData = Objects.requireNonNull(getData(virtualViewId));
            int startX = mFirstColumnMarginStart + (virtualViewId - mStartIndex) * (mSpaceWidth
                    + mColumnWidth);
            int endX = startX + mColumnWidth;
            mAccessRect.set(startX, mLineTopY, endX, mLineBottomY);
            node.setBoundsInParent(mAccessRect);
            int max = dayColumnData.getMax();
            int min = dayColumnData.getMin();
            node.setClickable(true);
            node.addAction(AccessibilityNodeInfoCompat.ACTION_CLICK);
            final Resources resources = getResources();
            String contentDescription = resources.getString(R.string.tb_blood_pressure_day_chart,
                    resources.getString(R.string.hour_in_day_format, virtualViewId), max, min);
            node.setContentDescription(contentDescription);
        }

        private DayColumnData getData(int selectIndex) {
            for (final DayColumnData data : mColumnData) {
                if (data.getIndex() == selectIndex) {
                    return data;
                }
            }
            return null;
        }

        @Override
        protected boolean onPerformActionForVirtualView(int virtualViewId, int action,
                @Nullable Bundle arguments) {
            if (action == AccessibilityNodeInfoCompat.ACTION_CLICK
                    && mChartHelper != null && mOnColumnClickListener != null) {
                mOnColumnClickListener.onClick(mSelectIndex);
            }
            return false;
        }
    }

1. ViewCompat.setAccessibilityDelegate(this, new MyAccessHelper(this));设置处理无障碍的代理
2. 较好实现无障碍的方式是借助ExploreByTouchHelper。（主要参考了Android 5.1系统源码中LockPatternView类的无障碍实现）编写相应的ExploreByTouchHelper类，重载必要的方法实现自定义view无障碍。

• int getVirtualViewAt(float x, float y)　x.y也就是我们处理onTouchEvent时获取的x,y　当有触摸事件时，根据x,y　返回当前是哪个结点，返回的int值由自己约定（和getVisibleVirtualViews方法对应，约定index）
• getVisibleVirtualViews(List<Integer> virtualViewIds) 添加想要聚焦的index 比如示例里　我只添加了有数据的分时柱子上，比如8,10,22 就代表8点,10点,22点 这三个有数据的位置需要播报无障碍.
• void onPopulateNodeForVirtualView(int virtualViewId, @NonNull AccessibilityNodeInfoCompat node) 给虚拟View设置描述文本和边框。在view刷新时，会遍历getVisibleVirtualViews我们添加的结点index，调用onPopulateNodeForVirtualView将焦点聚集，在node上设置要播报的内容,(还可以为其添加点击事件,添加的事件要在onPerformActionForVirtualView)处理，而setBoundsInParent方法传入一个rect,边框是指无障碍模式下选中的区块边界。
• onPerformActionForVirtualView 提供交互，触发回调重绘控件

3. 重写dispatchHoverEvent事件　处理以及发送事件

精选参考文章:

无障碍学习整理（基于talkback）
从源码看Accessibility事件分发流程

无障碍功能概览 让应用无障碍_中文版对应 构建无障碍服务|Android开发
360烽火实验室 Android Accessibility安全性研究报告