Android无障碍适配指南

前言: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安全性研究报告

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,511评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,495评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,595评论 0 225
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,558评论 0 190
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,715评论 3 270
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,672评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,112评论 2 291
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,837评论 0 181
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,417评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,928评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,316评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,773评论 2 234
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,253评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,827评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,440评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,523评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,583评论 2 249