Android无障碍适配指南

作者: 芒果味的你呀 | 来源:发表于2020-07-13 17:27 被阅读0次
前言:Android 应用的目标应该是让所有人都可以使用,包括有无障碍功能需求的人士。
有视觉障碍、色盲、视觉障碍、精细动作失能、认知障碍以及很多其他残疾的人员在日常生活中使用 Android 设备来完成各项任务。如果您能够在开发应用时考虑无障碍功能,那么您便可以改善用户体验,尤其是对于具有这些障碍和其他无障碍功能需求的用户来说。
在日常工作来说,对于一些系统性要求的公司,也是作为必须适配项之一。

1.启用焦点导航

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

如果视图不是默认聚焦,可以在布局文件中设置[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 提供交互,触发回调重绘控件
  1. 重写dispatchHoverEvent事件 处理以及发送事件

精选参考文章:

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

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

相关文章

网友评论

    本文标题:Android无障碍适配指南

    本文链接:https://www.haomeiwen.com/subject/kohwqktx.html