1 辅助***介绍
2026-10-13 更新:本文原写于 2014 年,介绍 Android 4.0(API 14)起的无障碍服务配置。无障碍服务本身仍然有效,但用它实现通用通知中心的路线已过时;Android 4.3(API 18)起应使用专门的 NotificationListenerService。下文修正服务声明和示例,并补充 Android 13(API 33)的节点回收变化。
辅助***(现通常称无障碍服务)用于帮助残障用户或暂时无法正常操作设备的用户使用应用,例如将界面文本读出来,或者提供触觉反馈。这一节介绍如何创建服务、接收界面事件和查询节点信息。
AccessibilityService 由系统在用户授权后绑定,不能当作普通后台任务服务来启动。下面给出服务骨架和几个方法的写法;接进自己的应用时,还需要补上语音引擎、设置界面和应用资源。服务生命周期与配置
2 创建自己的辅助***
2.1 继承 AccessibilityService
一个辅助***可以放在现有应用中,也可以作为独立应用提供。在工程中创建继承 AccessibilityService 的类,并实现两个必要回调:
1 2 3 4 5 6 7 8 9 10 11 12 13
| import android.accessibilityservice.AccessibilityService; import android.view.accessibility.AccessibilityEvent;
public class MyAccessibilityService extends AccessibilityService { @Override public void onAccessibilityEvent(AccessibilityEvent event) { }
@Override public void onInterrupt() { } }
|
onAccessibilityEvent() 接收匹配配置的事件;onInterrupt() 要求中断当前反馈,例如停止朗读,并不表示服务已经断开。
2.2 在 Manifest 中声明 service
在 AndroidManifest.xml 的 <application> 内添加服务声明。BIND_ACCESSIBILITY_SERVICE 限制只有系统可以绑定;它写在服务的 android:permission 属性上。显式声明 android:exported 也满足 Android 12(targetSdk 31)起带 intent filter 的组件要求。
1 2 3 4 5 6 7 8 9
| <service android:name=".MyAccessibilityService" android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE" android:exported="true"> <intent-filter> <action android:name="android.accessibilityservice.AccessibilityService" /> </intent-filter> </service>
|
系统通过这个 action 识别无障碍服务,事件类型由下一节的配置控制。完整声明还需要加上指向 XML 的元数据。
2.3 配置 service
服务可以不提供启动 Activity;如果需要说明授权用途或提供设置,可以保留 Activity。接下来要配置的是:响应哪些事件?对所有应用生效,还是只处理指定的包?采用什么反馈?这些由 AccessibilityServiceInfo 控制。
运行时调整配置可以使用 setServiceInfo()。下面的方法放入服务类,并导入 android.accessibilityservice.AccessibilityServiceInfo;从已有配置开始修改,保留 XML 中的其他设置:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
| @Override protected void onServiceConnected() { AccessibilityServiceInfo info = getServiceInfo(); if (info == null) { return; } info.eventTypes = AccessibilityEvent.TYPE_VIEW_CLICKED | AccessibilityEvent.TYPE_VIEW_FOCUSED; info.packageNames = new String[] {"com.example.android.myFirstApp", "com.example.android.mySecondApp"}; info.feedbackType = AccessibilityServiceInfo.FEEDBACK_SPOKEN; info.flags = AccessibilityServiceInfo.DEFAULT; info.notificationTimeout = 100; this.setServiceInfo(info); }
|
这里的包名只是示例,要换成需要辅助的应用。notificationTimeout 是事件通知的节流间隔,单位为毫秒,不是服务存活时间。
Android 4.0(API 14)起也可以在 res/xml/serviceconfig.xml 中配置服务;canRetrieveWindowContent 这类能力需要通过 XML 声明。与上面事件范围对应的配置如下:
1 2 3 4 5 6 7
| <accessibility-service xmlns:android="http://schemas.android.com/apk/res/android" android:accessibilityEventTypes="typeViewClicked|typeViewFocused" android:packageNames="com.example.android.myFirstApp, com.example.android.mySecondApp" android:accessibilityFeedbackType="feedbackSpoken" android:notificationTimeout="100" android:canRetrieveWindowContent="true" />
|
feedbackSpoken 声明反馈类型,不会自动实现朗读。若提供 settingsActivity,必须指向项目中实际存在且已声明的 Activity。
使用 XML 配置时,把上一节的服务声明补全为下面的形式:
1 2 3 4 5 6 7 8 9 10
| <service android:name=".MyAccessibilityService" android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE" android:exported="true"> <intent-filter> <action android:name="android.accessibilityservice.AccessibilityService" /> </intent-filter> <meta-data android:name="android.accessibilityservice" android:resource="@xml/serviceconfig" /> </service>
|
元数据的资源名必须与 XML 文件名一致。配置选项以 AccessibilityServiceInfo 为准。
2.4 响应 AccessibilityEvent 事件
在 onAccessibilityEvent() 中用 getEventType() 区分事件。以下节选读取内容描述;它可能为空,因此也检查事件携带的文本:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
| @Override public void onAccessibilityEvent(AccessibilityEvent event) { final int eventType = event.getEventType(); String eventText; switch(eventType) { case AccessibilityEvent.TYPE_VIEW_CLICKED: eventText = "Clicked: "; break; case AccessibilityEvent.TYPE_VIEW_FOCUSED: eventText = "Focused: "; break; default: return; }
CharSequence label = event.getContentDescription(); if (label == null && !event.getText().isEmpty()) { label = event.getText().get(0); } if (label == null) { return; } eventText = eventText + label; }
|
这个回调运行在服务主线程上,耗时处理需要另外安排;注释处的语音反馈也需要处理初始化和中断。
需要更多上下文时,可以查询无障碍节点树。Android 4.0(API 14)起提供这项能力,需要在前面的 XML 中设置:
1
| android:canRetrieveWindowContent="true"
|
event.getSource() 返回节点信息,也可能返回 null:事件类型、服务能力和节点是否仍然可用都会影响结果,不能只按窗口是否活动来判断。无障碍节点树也不保证与 View 层级一一对应。getSource() 文档
下面是替代前一个回调的节点处理示例,假定已知布局中,事件源的父节点有两个子节点:第一个是标签,第二个是复选框。真实应用要按其无障碍语义定位节点,不能对任意应用套用子节点下标。此节选需导入 AccessibilityNodeInfo 和 android.os.Build,使用 compileSdk 33 或更高版本:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
| @Override public void onAccessibilityEvent(AccessibilityEvent event) { AccessibilityNodeInfo source = event.getSource(); AccessibilityNodeInfo rowNode = null; AccessibilityNodeInfo labelNode = null; AccessibilityNodeInfo completeNode = null; try { if (source == null) return; rowNode = source.getParent(); if (rowNode == null || rowNode.getChildCount() < 2) return; labelNode = rowNode.getChild(0); completeNode = rowNode.getChild(1); if (labelNode == null || completeNode == null || !completeNode.isCheckable()) return; CharSequence label = labelNode.getText(); if (label == null) return; String report = label + (completeNode.isChecked() ? " (checked)" : " (not checked)"); } finally { recycleBeforeAndroid13(completeNode); recycleBeforeAndroid13(labelNode); recycleBeforeAndroid13(rowNode); recycleBeforeAndroid13(source); } }
@SuppressWarnings("deprecation") private static void recycleBeforeAndroid13(AccessibilityNodeInfo node) { if (node != null && Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) { node.recycle(); } }
|
Android 13(API 33)取消了这类节点的对象池,recycle() 已废弃且不再起作用;兼容旧系统时,仍应在使用完获取的节点后回收。上面的 finally 保证提前返回时也处理节点。AccessibilityNodeInfo.recycle()
安装后还需要用户到「设置 → 无障碍」启用服务。只有授权、目标包名和事件配置都满足条件,系统才会把匹配事件交给服务;注册 Manifest 不代表已经获得授权。
关于我 && 博客
下面是个人的介绍和相关的链接,期望与同行的各位多多交流,三人行,则必有我师!
- 博主个人介绍 :里面有个人的微信和微信群链接。
- 本博客内容导航 :个人博客内容的一个导航。
- 个人整理和搜集的优秀博客文章 - Android 性能优化必知必会 :欢迎大家自荐和推荐 (微信私聊即可)
- Android性能优化知识星球:付费社群已于 2026 年停止运营,不再招收新成员;此处保留历史介绍。
一个人可以走的更快 , 一群人可以走的更远
