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() {
// Stop any accessibility feedback currently being delivered.
}
}

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
<!-- Inside the existing <application> element. -->
<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;
// Pass eventText to the app's initialized text-to-speech implementation.
}

这个回调运行在服务主线程上,耗时处理需要另外安排;注释处的语音反馈也需要处理初始化和中断。

需要更多上下文时,可以查询无障碍节点树。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)");
// Deliver report through the app's feedback implementation.
} 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 不代表已经获得授权。

关于我 && 博客

下面是个人的介绍和相关的链接,期望与同行的各位多多交流,三人行,则必有我师!

  1. 博主个人介绍 :里面有个人的微信和微信群链接。
  2. 本博客内容导航 :个人博客内容的一个导航。
  3. 个人整理和搜集的优秀博客文章 - Android 性能优化必知必会 :欢迎大家自荐和推荐 (微信私聊即可)
  4. Android性能优化知识星球:付费社群已于 2026 年停止运营,不再招收新成员;此处保留历史介绍。

一个人可以走的更快 , 一群人可以走的更远

微信扫一扫