Android 无障碍开发入门

一、AccessibilityService

根据官方的介绍，是指开发者通过增加类似contentDescription的属性，从而在不修改代码的情况下，让残障人士能够获得使用体验的优化，大家可以打开AccessibilityService来试一下，点击区域，可以有语音或者触摸的提示，帮助残障人士更好的使用App

现在被广泛应用在自动化，比如自动抢红包，抖音自动关注点赞等

官方文档：

https://developer.android.com/guide/topics/ui/accessibility/service

二、AccessibilityService 开发流程

1.确定执行脚本的APK安装包

2.通过UIAutomator 获取包名及UI控件ID，或者下载一个开发者助手apk，也可以进行控件ID获取，代码君已经帮你下载好了，需要自取

http://share.dmjzy.cn/f/17143538-501591536-a374b2（访问密码：8401）

3.编写脚本代码

4.调试、兼容性处理

三、核心代码

1.AccessibilityService主要是实现onAccessibilityEvent

public class AccessibilitySampleService extends AccessibilityService{

    /**当无障碍服务连接之后回调*/
   @Override
   public void  onServiceConnected() {
        super.onServiceConnected()
    }

    /**当触发了需要监听的无障碍事件后回调*/
   @Override 
   public void onAccessibilityEvent(AccessibilityEvent event){
       // 获取包名
       String pkgName = event.getPackageName().toString();
       int eventType = event.getEventType();

       AccessibilityOperator.getInstance().updateEvent(this, event);
       //过滤出目标包，如果要检测所有包，可以去掉此判断
       if (pkgName.equals(pageName)) {
           AccessibilityLog.printLog("eventType: " + eventType + " pkgName: " + pkgName);

           switch (eventType) {
               case AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED:
                   //执行具体的脚本
                   toOperator();
                   break;
               case AccessibilityEvent.TYPE_VIEW_CLICKED:
                   break;
               case AccessibilityEvent.TYPE_VIEW_LONG_CLICKED:
                   break;
               case AccessibilityEvent.TYPE_NOTIFICATION_STATE_CHANGED:
                   break;
           }
       }
   } 
   /**无障碍服务断开后回调*/
   @Override 
   public void onInterrupt(){
       // TODO Auto-generated method stub 
   }
}

方法说明

1. onServiceConnected

当声明的无障碍服务连接之后, 系统会回调此方法. 在这个方法里, 可以做一些初始化工作. 比如保存服务的实例 标识服务连接的状态等.

也可以通过

android.accessibilityservice.AccessibilityService#getServiceInfo

动态更改xml配置文件中声明的无障碍配置信息.

2. onAccessibilityEvent

当监听的事件触发时, 系统会回调此方法, 比如view被点击了 window内容改变了等.

可以用

android.view.accessibility.AccessibilityRecord#getSource

获取对象AccessibilityNodeInfo, 这个对象就是无障碍操作的核心对象, 通常可以理解为android开发中的view控件.

可以通过AccessibilityNodeInfo对象, 进行控件的点击操作 输入文本操作 滚动操作 获取文本操作等

3. onInterrupt

当中途关闭了无障碍服务时回调, 通常这个时候无障碍服务不可用, 调用api都会失败.

4. AccessibilityService 其他方法说明

更多AccessibilityService参数说明见官方文档:

https://developer.android.google.cn/reference/kotlin/android/accessibilityservice/AccessibilityService

AccessibilityEvent

2. AndroidManifest.xml注册服务

<!-- 注册辅助功能服务-->
       <service
           android:name=".AccessibilitySampleService"
           android:exported="true"
           android:label="码君助手"
           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>

3. 在资源文件夹新增xml文件夹，新建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:canPerformGestures="true"
    android:description="@string/accessibility_desc"
    android:notificationTimeout="10" />

<!--  canPerformGestures  //申请手势权限-->
<!--accessibility_desc:码君助手，让你的手机更智能一点 -->

accessibility_config说明

官方文档说明：

https://developer.android.google.cn/reference/android/R.styleable#AccessibilityService

这里列举一些比较常用的

4、编写执行脚本

try {
           Thread.sleep(2000);
           AccessibilityOperator.getInstance().clickById("com.xxxx.packagename:id/btn_later");// 关闭弹框

           Thread.sleep(1000);
           AccessibilityOperator.getInstance().clickById("com.xxxx.packagename:id/tab_work");//切换到工作tab
           AccessibilityLog.printLog("切换到工作tab: ");

       } catch (InterruptedException e) {
           e.printStackTrace();
       }

AccessibilityNodeInfo

更多请查看官方文档:

https://developer.android.google.cn/reference/android/view/accessibility/AccessibilityNodeInfo