Android辅助功能原理与基本使用详解-AccessibilityService

辅助功能原理与基本使用详解

本文主要介绍辅助功能的使用

1. 辅助功能基本原理
2. 辅助功能基本配置和框架搭建
3. 辅助功能实战解析

1、辅助功能基本原理

  辅助功能（AccessibilityService）实际上是一个Android系统提供给的一种服务，自己是继承Service类的。这个服务提供了加强的用户界面，旨在帮助残障人士或者可能暂时没法与设备充分交互的人们。

  从开发者的角度看，其实就是提供两种功能：查找界面元素，实现模拟点击。实现一个辅助功能服务要求继承AccessibilityService类并实现它的抽象方法。自定义一个服务类AccessibilitySampleService（这个命名能够随意），继承系统的AccessibilityService并覆写onAccessibilityEvent和onInterrupt方法。编写好服务类以后，在系统配置文件（AndroidManifest.xml）中注册服务。完成前面两个步骤就完成了基本发辅助功能服务注册与配置，具体的功能实现须要在onAccessibilityEvent中完成，根据onAccessibilityEvent回调方法传递过来的AccessibilityEvent对象能够对事件进行过滤，结合AccessibilitySampleService自己提供的查找节点与模拟点击相关的接口便可实现权限节点的查找与点击。

2、辅助功能基本配置和框架搭建

建立自定义辅助功能服务类

import android.accessibilityservice.AccessibilityService;
import android.view.accessibility.AccessibilityEvent;

import com.accessibility.utils.AccessibilityLog;
public class AccessibilitySampleService extends AccessibilityService {

    @Override
    protected void onServiceConnected() {
        super.onServiceConnected();
    }

    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {
        // 此方法是在主线程中回调过来的，因此消息是阻塞执行的
        // 获取包名
        String pkgName = event.getPackageName().toString();
        int eventType = event.getEventType();
        // AccessibilityOperator封装了辅助功能的界面查找与模拟点击事件等操做
        AccessibilityOperator.getInstance().updateEvent(this, event);
        AccessibilityLog.printLog("eventType: " + eventType + " pkgName: " + pkgName);
        switch (eventType) {
            case AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED:
                break;
        }
    }

    @Override
    public void onInterrupt() {

    }
}

注册辅助功能服务

// 注册辅助功能服务
<service android:name=".AccessibilitySampleService"
    android:label="@string/accessibility_tip"
    android:exported="true"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE"
    android:process=":BackgroundService">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    // 经过xml文件完成辅助功能相关配置，也能够在onServiceConnected中动态配置
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/accessibility_config"/>
</service>

上面android:label="@string/accessibility_tip"是配置此辅助功能服务在系统辅助功能页面里面显示的名字。

accessibility_config文件内容以下：

<?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:canRetrieveWindowContent="true"
    android:description="@string/accessibility_desc"
    android:notificationTimeout="100" />

跳转到系统辅助功能页面，开启辅助功能服务

  完成上面配置以后，辅助功能服务就注册成功了，在系统辅助功能页面就能找到这个服务，可是默认是关闭的，也就是说，这个服务要开始为咱们服务，还须要去系统界面开启那个开关。下面是跳转到辅助功能页面的代码，跳转过去以后，手动点击开关按钮。开关打开以后，这个辅助功能服务就开始工做了，系统开始回调onAccessibilityEvent方法。咱们能够在onAccessibilityEvent方法中处理查找节点与点击操做。

public class OpenAccessibilitySettingHelper {
    private static final String ACTION = "action";
    private static final String ACTION_START_ACCESSIBILITY_SETTING = "action_start_accessibility_setting";

    public static void jumpToSettingPage(Context context) {
        try {
            Intent intent = new Intent(context,  AccessibilityOpenHelperActivity.class);
            intent.putExtra(ACTION, ACTION_START_ACCESSIBILITY_SETTING);
            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            context.startActivity(intent);
        } catch (Exception ignore) {}
    }
}

下图是小米手机开启辅助功能的界面

3、辅助功能实战解析

实现界面自动点击操做，动画有点模糊，将就看吧

界面节点查找与模拟点击

  AccessibilityOperator封装了辅助功能的界面查找与模拟点击事件等操做，下面介绍几个关键的技术点。

界面节点查找操做

  AccessibilityNodeInfo提供两种查找View节点的方法

1. 根据View的ID精确查找，可是要求SDK_INT >= 18才能用

/**
 * 根据View的ID搜索符合条件的节点,精确搜索方式;
 * 这个只适用于本身写的界面，由于ID可能重复
 * api要求18及以上
 * @param viewId
 */
public List<AccessibilityNodeInfo> findNodesById(String viewId) {
    AccessibilityNodeInfo nodeInfo = getRootNodeInfo();
    if (nodeInfo != null) {
        if (Build.VERSION.SDK_INT >= 18) {
            return nodeInfo.findAccessibilityNodeInfosByViewId(viewId);
        }
    }
    return null;
}

2. 根据View的Text文本进行模糊查找

/**
 * 根据Text搜索全部符合条件的节点, 模糊搜索方式
 */
public List<AccessibilityNodeInfo> findNodesByText(String text) {
    AccessibilityNodeInfo nodeInfo = getRootNodeInfo();
    if (nodeInfo != null) {
       return nodeInfo.findAccessibilityNodeInfosByText(text);
    }
    return null;
}

模拟界面操做

1. 普通的View事件模拟（ACTION_CLICK）

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的类型
            AccessibilityLog.printLog("View类型：" + node.getClassName());
            // 进行模拟点击
            if (node.isEnabled()) {
                return node.performAction(AccessibilityNodeInfo.ACTION_CLICK);
            }
        }
    }
    return false;
}

2. 全局事件模拟（返回键：AccessibilityService.GLOBAL_ACTION_BACK）

public boolean clickBackKey() {
    return performGlobalAction(AccessibilityService.GLOBAL_ACTION_BACK);
}

private boolean performGlobalAction(int action) {
    return mAccessibilityService.performGlobalAction(action);
}

源码地址

https://github.com/PopFisher/AccessibilitySample