Android 一文学会无障碍服务（AccessibilityService）

什么是无障碍服务？

无障碍服务（AccessibilityService）是一套可以模拟操作的系统级别的API。用户同意我们的应用获取无障碍服务的权限之后就可以模拟操作，来控制用户的手机。无障碍被广泛用于抢红包、自动回复、一键获取权限等应用中。
无障碍服务的好处很多，可以实现一键操作，帮助残障人士使用手机。当然坏处也有，开启无障碍服务以后，因为服务对手机的实时监控，会引起手机的卡顿。这个怎么优化我们待会会说到。

无障碍服务文档和说明

以下我将结合各大博主的文章、Google官方文档对无障碍服务进行一个全方位的概述。

安卓官方文档AccessibilityService

First Step

AndroidManifest.xml添加声明
注意：1.对AccessibilityService的权限的申请.
2.在meta-data里加上你的无障碍服务的配置文件

<manifest> 
  <application> 
    <service  android:name = ".YourAccessibilityServiceName" 
        <!--用于显示在设置界面的标签.就跟桌面图标下面的标签一样的作用-->
        android:label = "@string/accessibility_service_label" 
        android:permission = "android.permission.BIND_ACCESSIBILITY_SERVICE" > 
      <intent-filter> 
        <action  android:name = "android.accessibilityservice.AccessibilityService"  /> 
      </intent-filter> 
     <meta-data 
        android:name = "android.accessibilityservice" 
        <!--注意：下面的配置文件是对你无障碍服务的配置信息-->
        android:resource = "@xml/accessibility_service_config"  /> 
    </service> 
    <uses-permission  android:name = "android.permission.BIND_ACCESSIBILITY_SERVICE"  /> 
  </application> 
</manifest>

Second Step

你的无障碍服务的配置文件

<accessibility-service
    xmlns:android="http://schemas.android.com/apk/res/android"
    //用于描述此服务的信息,会显示在系统开启服务的设置界面
    android:description="@string/app_accessibility_description"
    //接收EventTypes的包名,多个包名用,隔开。如果不设置就是接收所有的。
    android:packageNames="com.tencent.mm,com.tencent.mobileqq"
    //可以接收的事件，这里这是typeAllMask就是接收所有的，注意这里接受的方法多了也会卡。
    android:accessibilityEventTypes="typeAllMask"
    //字面意思:反馈类型.官方解释真的"很详细".
    android:accessibilityFeedbackType="feedbackAllMask"
    //发送2次事件的时间间隔,超过后事件作废
    android:notificationTimeout="100"
    //设置界面,在系统的启动服务界面会出现一个设置按钮,用来打开这个Activity的;
    android:settingsActivity="com.angcyo.SettingsActivity"
    //官方解释很模糊,暂且就使用缺省值吧
    android:accessibilityFlags="flagDefault"
    //表明此服务是否可以读取窗口中的内容,应该是最重要的属性了.在运行时不可修改;
    android:canRetrieveWindowContent="true"/>

Third Step

检查无障碍服务权限的方法

调用事例：

boolean b = isServiceON(this, YourAccessibilityServiceName.class.getName()

方法：

public static boolean isServiceON(Context context,String className){
        ActivityManager activityManager = (ActivityManager)context.getSystemService(context.ACTIVITY_SERVICE);
        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().contains(className)){
                return true;
            }
        }
        return false;
    }

跳转到无障碍服务设置页

Intent intent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
startActivity(intent);

可以结合判断和跳转，进行用户引导。

Fourth Step

开始写一个AccessibilityService

public class RsenAccessibilityService extends AccessibilityService {

  @Override
  protected void onServiceConnected() {
      super.onServiceConnected();
      //服务开启时，调用
      //setServiceInfo();这个方法同样可以实现xml中的配置信息
  	  //可以做一些开启后的操作比如点两下返回
  }

  @Override
  public boolean onUnbind(Intent intent) {
      //关闭服务时,调用
      //如果有资源记得释放
      return super.onUnbind(intent);
  }

  @Override
  public void onAccessibilityEvent(AccessibilityEvent event) {
  	  //这个方法是我们用的最多的方法，我们会在这个方法里写大量的逻辑操作。
  	  //通过对event的判断执行不同的操作
      //当窗口发生的事件是我们配置监听的事件时,会回调此方法.会被调用多次
  }

  @Override
  public void onInterrupt() {
      //当服务要被中断时调用.会被调用多次
  }
}

Fifth Step

看看我们能监听哪些事件

可以监听到的事件大全

这个可以以后参照着使用，具体使用中可以用 event.toString() 打印出来，然后自行记录判断。

Sixth Step

获取结点的几个方法
可以通过resource-id，text来定位到结点，如果可以，建议使用后者，因为一般APP更新后，这个id都会发生变化，（所以微信更新后都需要做适配，就是更新这个id）

通过UI Automator来查看布局层次

旧版的Android Studio，Ctrl + alt + A，输入 monitor 可以找到，新版的
Android Studio是找不到的，你需要来到android-sdk/tools目录下：

连接手机后，点击顶部的：

接着可以看到当前页面的层次结构图。
需要注意的是resource-id不一定是唯一！！！

Seventh Step

getRootInActiveWindow( )：获取当前整个活动窗口的根节点，返回的是一个AccessibilityNodeInfo类，代表View的状态信息， 提供了下述几个非常实用的方法：

方法名	解释
findAccessibilityNodeInfosByViewId	通过视图id查找节点元素。
findAccessibilityNodeInfosByText	通过字符串查找节点元素。
getParent	获取父节点。
getChild	获取子节点。

找结点要注意判空，找不到对应结点直接调用其他方法会空指针异常。
找到结点然后就是一些动作了，常用的点击，长按，滚动和输入文字。代码示例如下：

/* 点击 */
node.performAction(AccessibilityNodeInfo.ACTION_CLICK)

/* 长按 */
node.performAction(AccessibilityNodeInfo.ACTION_LONG_CLICK)

/* 滚动 */
listNode.performAction(AccessibilityNodeInfo.ACTION_SCROLL_FORWARD) //向上滚动
listNode.performAction(AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD) //向下滚动

/* 输入文字 */
val arguments = Bundle()
arguments.putCharSequence(AccessibilityNodeInfo.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE,"xxx")
editNode.performAction(AccessibilityNodeInfo.ACTION_SET_TEXT, arguments)

/* 通过粘贴板输入文字 */
public static void sendTextForEditText(Context context, AccessibilityNodeInfo editNode, String text) {
    if (editNode != null) {
        ClipboardManager clipboard = (ClipboardManager)context.getSystemService(Context.CLIPBOARD_SERVICE);
        ClipData clip = ClipData.newPlainText("text", text);
        clipboard.setPrimaryClip(clip);
        //获得焦点
        editNode.performAction(AccessibilityNodeInfo.ACTION_FOCUS);
        //粘贴内容
        edittext.performAction(AccessibilityNodeInfo.ACTION_PASTE);
    }
}

AccessibilityService本身特有的方法，如模拟回退键，Home键等。这个是全局方法，我们还可以通过dispatchGesture()方法来让无障碍服务实现webView层的操作，只要我们指定好坐标就可以。这个后面会说。

performGlobalAction(AccessibilityService.GLOBAL_ACTION_BACK)    
//回退
performGlobalAction(AccessibilityService.GLOBAL_ACTION_HOME)    
//Home键
performGlobalAction(AccessibilityService.GLOBAL_ACTION_NOTIFICATIONS)    
//点击notification

注意的点

1.应用崩溃后需要去设置页重新关闭再开启，否则无障碍服务将不可用。
2.调试期间可以获取监听所有的方法，最后发布软件时需要只留自己需要的监听事件，如果全部都用就会引起卡顿。
3.获取节点后一定需要判断是否为空后再使用，否则容易导致程序崩溃。