android accessibility

主要介绍如开发作符合accessibility规范的应用，和开发自己的accessibility service。一、开发作符合accessibility规范的应用（ Making Applications Accessible ）主要有以下三点： 1. Labeling User Interface Elements 这点很简单，如果你都用android自带的控件（像TextView, Button等），大部分事情系统都帮你做了。你只需要在一些没有文字提示的控件（像ImageButton,ImageView,CheckBox等），使用 android:contentDescription属性，增加文字提示内容，如下代码： android:id=”@+id/add_note_button” android:src=”@drawable/add_note” android:contentDescription=”@string/add_note”/> AccessibilityService可以通过调用getContentDescription来获取contentDescription的内容。 2. Enabling Focus Navigation 这点也很简单，就是要保证你所有需要操作的控件，都可以方向键导航来换取焦点。 3. Building Accessible Custom Views 如果使用自定义accessibility控件的话，就需要自己处理accessibility 事件。了解自定义accessibility控件的方法，有助于理解accessibility框架的原理。自定义accessibility控件主要包含以下4点：（1） Handle directional controller clicks 在获取焦点的View，接收到ok键或回车键的时候，需要执行点击事件的行为。（2）Implement accessibility API methods 主要有以下四个方法（第4点会更详细介绍）： dispatchPopulateAccessibilityEvent() onPopulateAccessibilityEvent() onInitializeAccessibilityEvent() onInitializeAccessibilityNodeInfo()
（3）Send AccessibilityEvent objects specific to your custom view 比如说，在你定制的控件获取焦点的时候，调用View.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED)等。
（4）Populate AccessibilityEvent and AccessibilityNodeInfo for your view 构建 AccessibilityEvent和 AccessibilityNodeInfo。这一点比较重要，因为如果我们开发accessibility service的时候，需要用到Accessibility和AccessibilityNodeInfo来获取accessibility 的消息。先来看看 AccessibilityNodeInfo的构造。看第（2）点的的四个函数。 onInitializeAccessibilityNodeInfo()用来初始化 AccessibilityNodeInfo。它会根据View的层次填充子View的 AccessibilityNodeInfo和父View的 AccessibilityNodeInfo。比如一个LinearLayout里面放置了两个Button，在回调LinearLayout的 onInitializeAccessibilityNodeInfo()的时候，就会给LinearLayout的 AccessibilityNodeInfo填充上两个子View的 AccessibilityNodeInfo。所以，你可以通过event.getSource()获取到一个和View的层次结构类似的树形 AccessibilityNodeInfo。再来看看 AccessibilityEvent的构造。看第（2）点第三个函数。 onInitializeAccessibilityEvent()用来初始化AccessibilityEvent的一些属性，如设置className,设置是否被选中等等。可以去看api说明，获取完整的设置属性。除了属性之外，还有一个非常重要的内容，就是accessibility的提示消息。主要通过 dispatchPopulateAccessibilityEvent()和 onPopulateAccessibilityEvent()这两个函数来获取的。看下图：这是 AccessibilityEvent.getText（）的填充过程。getText()返回的是一个字符数组。可以看到，ViewGroup调用dispatchPopulateAccessibilityEvent之后，会触发自身的onPopulateAccessibilityEvent函数。在这个函数里，可以调用event.getText().add(String)的方法来填充数据。接下来就会遍历所有的子View，调用每个子View的 dispatchPopulateAccessibilityEvent方法，然后 dispatchPopulateAccessibilityEvent触发自身的 onPopulateAccessibilityEvent函数。同样，在这个函数里，可以调用event.getText().add(String)的方法来填充数据。这边有一点要强调一下，ViewGroup和View的AccessibilityEvent是同一个event。这样子，你就可以获取ViewGroup及其所有子View的accessibility消息了。
二、开发自己的accessibility service( Building Accessibility Services ). 主要有以下五点： 1. Manifest Declarations and Permissions 看下面例子：
...

...

...
android:name =". MyAccessibilityService "
android:label ="@string/ accessibility_service_label "
android:permission =" android.permission.BIND_ACCESSIBILITY_SERVICE ">

android:name =" android.accessibilityservice.AccessibilityService " />

android:name="android.accessibilityservice"
android:resource="@xml/accessibility_service_config" />

android:name =" android.permission.BIND_ACCESSIBILITY_SERVICE " />

红色字体是需要添加的权限和intent-filter，绿色字体是配置文件的信息。配置文件看以下例子： xmlns:android ="http://schemas.android.com/apk/res/android"
android:description ="@string/ accessibility_service_description “

            android:canRequestFilterKeyEvents="true"
  android:packageNames="com.example.android.apis"
  android:accessibilityEventTypes="typeAllMask"
  android:accessibilityFlags="flagDefault"
  android:accessibilityFeedbackType="feedbackSpoken"
  android:notificationTimeout="100"
  android:canRetrieveWindowContent="true"
  android:settingsActivity="com.example.android.accessibility.ServiceSettingsActivity"
/>

其中，红色字体是注册的包名和accessibility 事件。表明只接收 com.example.android.apis这个应用的所有accessibility时间。当然，这两个属性可以在运行时改变。其他属性可以去参考api文档。 2. Registering for Accessibility Events 如上面例子，可以通过包名和事件来过滤AccessibilityEvent. 3. AccessibilityService Methods 主要有以下四个方法： onServiceConnected()：可以用来初始化操作，如初始化TTS，设置accessibilityEvent的过滤条件等。 onAccessibilityEvent()：接收你注册的accessibility事件。 onInterrupt()：看以下官方解释：This method is called when the system wants to interrupt the feedback your service is providing, usually in response to a user action such as moving focus to a different control. This method may be called many times over the lifecycle of your service onUnbind()。我的理解是，系统中断你的accessibility service回馈的时候调用。例如，你用TTS语言提示一个accessibility 消息的时候，还没提示完，又来的一个accessibility event，这时候，正在播报的事件就会被中断，就会回调这个函数。但是，在我实际开发过程中，没有用到这个函数。我开发的也是用TTS提示，需要中断的话，会调用TTS的Tts.speak(text, TextToSpeech.QUEUE_FLUSH , null,null),TTS自己会中断之前的提示，无需用到onInterrupt()方法。 onUnbind()：在accessibility service关闭的时候调用。用来清除一些系统资源等。和onSerciceConnected相对应。
4. Getting Event Details 这是在系统回调 onAccessibilityEvent()的时候获取的，主要有两个数据： AccessibilityEvent：在 onAccessibilityEvent()的参数列表里。参照之前自定义accessibility View的章节，调用event.getText（）来获取accessibility消息，还可以调用其他方法获取包名类名等消息。具体方法参照文档。 AccessibilityNodeInfo：主要用来遍历View的AccessibilityNodeInfo信息。参考之前自定义accessibility View的章节，调用AccessibilityEvent.getSource（）获取当前View的 AccessibilityNodeInfo , 通过 AccessibilityNodeInfo.getChild(index)和 AccessibilityNodeInfo. getParent()获取子View和父View的 AccessibilityNodeInfo。
5. Taking Action for Users accessibility service也可以执行一些操作，如让View获取焦点等，通过调用 AccessibilityNodeInfo. performAction()来实现。也可以执行一些全局的操作，如回到launcher等，通过调用 AccessibilityService.performGlobalAction()来实现。

更多相关文章

随机推荐