Android辅助功能(无障碍)使用---AccessibilityService

参考资料：https://github.com/PopFisher/AccessibilitySample

1.Android文档里`AccessibilityService`简介

辅助功能只在帮助残障人士使用Android设备和app的时候使用。
服务进程被杀掉后，下次启动，需再次申请权限

2.实现辅助功能服务

实现辅助功能，需要实现AccessibilityService类，并重写onAccessibilityEvent和onInterrupt方法。

代码：

public class AccessibilityTestService extends AccessibilityService {@Overridepublic void onAccessibilityEvent(AccessibilityEvent event) {String packageName = event.getPackageName().toString();int eventType = event.getEventType();Log.i("accessibility", "packageName = " + packageName + " eventType = " + eventType);}@Overridepublic void onInterrupt() {}
}

开启服务权限后运行，不同页面，打印不同的packageName和eventType
结果：

packageName = com.android.mms eventType = 2048
packageName = com.miui.home eventType = 32
packageName = com.miui.home eventType = 1
packageName = com.android.camera eventType = 2048
packageName = com.android.camera eventType = 32
packageName = com.android.camera eventType = 2048
packageName = com.android.camera eventType = 2048
packageName = com.miui.home eventType = 32
packageName = com.miui.securitycenter eventType = 64
packageName = com.android.systemui eventType = 2048

3.注册服务

在AndroidManifest中注册服务完成配置。
代码：

<serviceandroid:name=".android.accessibility.AccessibilityTestService"android:exported="true"android:label="@string/testAccessibility"android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE"><intent-filter><action android:name="android.accessibilityservice.AccessibilityService" /></intent-filter><meta-dataandroid:name="android.accessibilityservice"android:resource="@xml/accessibility_config" />
</service>

label标签是在申请权限的设置页面显示该服务的名字。其中需要的permission和<intent-filter>是必须的，缺少任何一个系统个都会无视这个服务。<meta-data>是该服务的一些配置，在xml路径下。

配置文件代码：

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"android:accessibilityEventTypes="typeAllMask"android:accessibilityFeedbackType="feedbackGeneric"android:accessibilityFlags="flagReportViewIds"android:canRetrieveWindowContent="true"android:description="@string/accessibility_desc"android:notificationTimeout="100" />

其中accessibilityFlags是一些额外声明，如果代码重要获取View的ID(通过调用AccessibilityNodeInfo的getViewIdResourceName()方法)，就必须加上权限flagReportViewIds。

4.跳转设置页面开启服务

先判断是否开启服务

if (!OpenAccessibilitySettingHelper.isAccessibilitySettingsOn(this,AccessibilityTestService.class.getName())) {// 判断服务是否开启OpenAccessibilitySettingHelper.jumpToSettingPage(this);// 跳转到开启页面
} else {ToastUtil.showShortToast(this, "服务已开启");//do other things...
}

OpenAccessibilitySettingHelper类：

public class OpenAccessibilitySettingHelper {//跳转到设置页面无障碍服务开启自定义辅助功能服务public static void jumpToSettingPage(Context context) {Intent intent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS);intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);context.startActivity(intent);}//判断自定义辅助功能服务是否开启public static boolean isAccessibilitySettingsOn(Context context, String className) {if (context == null) {return false;}ActivityManager activityManager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);if (activityManager != null) {List<ActivityManager.RunningServiceInfo> runningServices =activityManager.getRunningServices(100);// 获取正在运行的服务列表if (runningServices.size() < 0) {return false;}for (int i = 0; i < runningServices.size(); i++) {ComponentName service = runningServices.get(i).service;if (service.getClassName().equals(className)) {return true;}}return false;} else {return false;}}
}

5.辅助功能具体实现类

模拟的一些点击，退出，拖动，获取界面信息等具体的实现方法，主要是通过节点查找，找到要操作的控件。
首先要在实现的AccessibilityTestService中重写的onAccessibilityEvent方法中和event绑定。

AccessibilityOperator.getInstance().updateEvent(this, event);

updateEvent方法

public void updateEvent(AccessibilityService service, AccessibilityEvent event) {if (service != null && mAccessibilityService == null) {mAccessibilityService = service;}if (event != null) {mAccessibilityEvent = event;}
}

根据text搜索所有符合的节点

public List<AccessibilityNodeInfo> findNodesByText(String text) {AccessibilityNodeInfo nodeInfo = getRootNodeInfo();if (nodeInfo != null) {Log.i("accessibility", "getClassName：" + nodeInfo.getClassName());Log.i("accessibility", "getText：" + nodeInfo.getText());if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR2) {//需要在xml文件中声明权限android:accessibilityFlags="flagReportViewIds"// 并且版本大于4.3 才能获取到view 的 IDLog.i("accessibility", "getClassName：" + nodeInfo.getViewIdResourceName());}return nodeInfo.findAccessibilityNodeInfosByText(text);}return null;
}

根据ID搜索所有符合的节点

public List<AccessibilityNodeInfo> findNodesById(String viewId) {AccessibilityNodeInfo nodeInfo = getRootNodeInfo();if (nodeInfo != null) {if (Build.VERSION.SDK_INT >= 18) {return nodeInfo.findAccessibilityNodeInfosByViewId(viewId);}}return null;
}

获取跟节点

private AccessibilityNodeInfo getRootNodeInfo() {AccessibilityEvent curEvent = mAccessibilityEvent;AccessibilityNodeInfo nodeInfo = null;if (Build.VERSION.SDK_INT >= 16) {if (mAccessibilityService != null) {nodeInfo = mAccessibilityService.getRootInActiveWindow();}} else {nodeInfo = curEvent.getSource();}return nodeInfo;
}

模拟点击

private boolean performClick(List<AccessibilityNodeInfo> nodeInfos) {if (nodeInfos != null && !nodeInfos.isEmpty()) {AccessibilityNodeInfo node;for (int i = 0; i < nodeInfos.size(); i++) {node = nodeInfos.get(i);// 获得点击View的类型Log.i("accessibility", "getClassName：" + node.getClassName());// 进行模拟点击if (node.isEnabled()) {if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {return node.performAction(AccessibilityNodeInfo.ACTION_CLICK);}}}}return false;
}

模拟退出键

@RequiresApi(api = Build.VERSION_CODES.JELLY_BEAN)
public boolean clickBackKey() {return mAccessibilityService.performGlobalAction(AccessibilityService.GLOBAL_ACTION_BACK);
}

需要调用的地方直接获取AccessibilityOperator实例，获取到需要操作的节点后调用模拟方法。

6.通过Android Device Monitor来直接获取界面中View的ID

如图所示，打开Android Device Monitor

可能会有报错信息，因为AndroidStudio自动默认选的是64位的环境，如果出错的话，可直接在该运行程序的目录手动开启

默认打开的是64位的，可手动打开第一个。
然后选中连接的模拟器，点击方框的按钮后，可以将手机当前页面的布局框架加载进来。

点击布局上需要获取resourceid的view 后，会出现该view的id，但是有些view没有id，代码里获取的也是null，例如GooglePlay里某个应用的安装按钮就没有resourceid。但是他的父布局是有resourceid的，可以利用获取父布局的节点，再获取该父布局的某个子节点。

获取某个节点的某个子节点代码：

private AccessibilityNodeInfo getChildNodeInfos(String id, int childIndex) {List<AccessibilityNodeInfo> listChatRecord = findNodesById(id);if (listChatRecord == null || listChatRecord.size() == 0) {return null;}AccessibilityNodeInfo parentNode = listChatRecord.get(0);//该节点int count = parentNode.getChildCount();Log.i("accessibility", "子节点个数 " + count);return childIndex < count ? parentNode.getChild(childIndex) : null;
}