Android 无障碍服务AccessibilityService

前言

谷歌提供了一种用于与app自动交互的手动无障碍服务,只要像正常的Android Service一样写一个继承AccessibilityService的类即可创建一个无障碍服务。当app有操作时系统就会通知你开启的服务,有时候遇到困难无障碍服务也是一个不得已的方案。

具体可以参照谷歌文档:https://developer.android.com/guide/topics/ui/accessibility/service

创建服务类

先创建一个app,实现一个继承AccessibilityService的Service

public class AccessibilitySampleService extends AccessibilityService {
    public static String TAG = "SharkChilli";

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

    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {
        // 此方法是在主线程中回调过来的,所以消息是阻塞执行的
 
    }

    @Override
    public void onInterrupt() {
    }
}

onServiceConnected方法中可以来配置服务的一些设置,比如监控哪些app的哪些动作之类的。
onAccessibilityEvent方法就是app发送交互后会调用的方法,相关的交互信息都在AccessibilityEvent 中。
谷歌官网的具体解释如下

  • onServiceConnected() -(可选)当系统成功连接到无障碍服务时,会调用此方法。使用此方法可为服务执行任何一次性设置步骤,包括连接到用户反馈系统服务,如音频管理器或设备振动器。如果您要在运行时设置服务的配置或做出一次性调整,从此处调用 setServiceInfo() 非常方便。
  • onAccessibilityEvent() -(必需)当系统检测到与无障碍服务指定的事件过滤参数匹配的 `AccessibilityEvent 时,会回调此方法。例如,当用户点击某个按钮或将焦点置于应用中的某个界面控件上,而无障碍服务正在为其提供反馈时。出现这种情况时,系统会调用此方法,并传递关联的 AccessibilityEvent,服务随后可以对其进行解读并用其向用户提供反馈。此方法可能会在服务的整个生命周期内被调用多次。
  • onInterrupt() -(必需)当系统要中断服务正在提供的反馈(通常是为了响应将焦点移到其他控件等用户操作)时,会调用此方法。此方法可能会在服务的整个生命周期内被调用多次。
  • onUnbind() -(可选)当系统将要关闭无障碍服务时,会调用此方法。使用此方法可执行任何一次性关闭流程,包括取消分配用户反馈系统服务,如音频管理器或设备振动器。

配置AndroidManifest.xml

和正常的Service一样需要到AndroidManifest.xml中配置我们实现的Service。

<service
            android:name="com.shark.service.AccessibilitySampleService"
            android:exported="true"
            android:label="@string/accessibility_tip"
            android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE"
            android:process=":BackgroundService">
            <!--为了被视为无障碍服务,您必须在清单的 application 元素中添加一个 service 元素(而非 activity 元素)。
            此外,在 service 元素中,您还必须添加一个无障碍服务 intent 过滤器。为了与 Android 4.1 及更高版本兼容,
            清单还必须保护该服务,方法是添加 BIND_ACCESSIBILITY_SERVICE 权限以确保只有系统可以绑定到它 -->
            <intent-filter>
                <action android:name="android.accessibilityservice.AccessibilityService" />
            </intent-filter>
            <!--从 Android 4.0 开始,您可以在清单中添加一个引用配置文件的 <meta-data> 元素,这样可让您为无障碍服务设置所有选项-->
            <meta-data
                android:name="android.accessibilityservice"
                android:resource="@xml/accessibility_config" />
 </service>

这里基本是固定的在meta-data信息中配置的android:resource="@xml/accessibility_config"是指定我们服务的配置信息,这个配置工作也可以在上面的onServiceConnected方法通过AccessibilityServiceInfo配置。

我们看看这两种的配置方式
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:canRetrieveWindowContent="true"
    android:description="@string/accessibility_desc"
    android:packageNames="com.shark.nougat"
    android:notificationTimeout="100" />

onServiceConnected方法中配置

protected void onServiceConnected() {
        super.onServiceConnected();
        AccessibilityServiceInfo accessibilityServiceInfo = new AccessibilityServiceInfo();
        accessibilityServiceInfo.eventTypes = AccessibilityEvent.TYPE_WINDOWS_CHANGED
                | AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED
                | AccessibilityEvent.TYPE_VIEW_CLICKED
                | AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED
                | AccessibilityEvent.TYPE_NOTIFICATION_STATE_CHANGED;
        accessibilityServiceInfo.feedbackType = AccessibilityServiceInfo.FEEDBACK_ALL_MASK;
        accessibilityServiceInfo.notificationTimeout = 0;
        accessibilityServiceInfo.flags = AccessibilityServiceInfo.DEFAULT;
        accessibilityServiceInfo.packageNames = new String[]{"com.shark.nougat"};
        setServiceInfo(accessibilityServiceInfo);
    }

如需详细了解可在无障碍服务配置文件中使用的 XML 属性,请点击以下链接转到相应的参考文档:

如需详细了解可在运行时动态设置的配置设置,请参阅 AccessibilityServiceInfo 参考文档


开启无障碍服务

将app安装后,到设置中开启服务


image.png

这个名称就是我们前面设置的lable


image.png

image.png

AccessibilityEvent的操作

开启后app只要有互动,系统就会将这次互动的相关信息封装到AccessibilityEvent中并调用onAccessibilityEvent方法,这里就介绍一下基本操作

判断操作的类型

public void onAccessibilityEvent(AccessibilityEvent event) {
        // 此方法是在主线程中回调过来的,所以消息是阻塞执行的
        switch (event.getEventType()) {
            /**
             * AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED,
             * 而会调用AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED,
             * 而AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED只要内容改变后都会调用,
             * 所以一般是使用AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED来作为监测事件的
             */
            case AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED:
                Log.i(TAG, "TYPE_WINDOW_STATE_CHANGED 界面改变");
                break;
            case AccessibilityEvent.TYPE_VIEW_CLICKED:
                Log.i(TAG, "TYPE_VIEW_CLICKED view被点击");
                break;
        }
    }

通过AccessibilityEvent.getEventType()可以获得这次互动的类型。更多类型可以参考官网文档

获得操作的app包名和Activity类名

String pkgName = event.getPackageName().toString();
String className = event.getClassName().toString();

AccessibilityNodeInfo操作

在无障碍服务中控件节点会包装为一个AccessibilityNodeInfo,通过这个类我们可以在代码中与之交互

获取root节点类型

private AccessibilityNodeInfo getRootNodeInfo() {
        AccessibilityEvent curEvent = mAccessibilityEvent;
        AccessibilityNodeInfo nodeInfo = null;
        if (Build.VERSION.SDK_INT >= 16) {
            // 建议使用getRootInActiveWindow,这样不依赖当前的事件类型
            if (mAccessibilityService != null) {
                nodeInfo = mAccessibilityService.getRootInActiveWindow();
                Log.d(TAG, "getRootNodeInfo: " + nodeInfo);
            }
            // 下面这个必须依赖当前的AccessibilityEvent
//            nodeInfo = curEvent.getSource();
        } else {
            nodeInfo = curEvent.getSource();
        }
        return nodeInfo;
    }

获取了根节点就可以向下去查找其他节点了

通过ID查找节点

nodeInfo.findAccessibilityNodeInfosByViewId(viewId);

id:"com.shark.nougat:id/sample_text"

通过Text查找节点

nodeInfo.findAccessibilityNodeInfosByText(text);

点击节点

node.performAction(AccessibilityNodeInfo.ACTION_CLICK);

修改文本

node.performAction(AccessibilityNodeInfo.ACTION_SET_TEXT, arguments);

点击全局返回、Home

performGlobalAction(AccessibilityService.GLOBAL_ACTION_BACK);
performGlobalAction(AccessibilityService.GLOBAL_ACTION_HOME);

uiautomatorviewer

我们可以使用sdk中自带的uiautomatorviewer查看app id等信息


image.png

引用

Github对AccessibilitySample封装
android 辅助功能(无障碍) AccessibilityService 实战入门详解
Android辅助功能(Accessibility)简介
Android辅助功能原理与基本使用详解-AccessibilityService

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,222评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,455评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,720评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,568评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,696评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,879评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,028评论 3 409
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,773评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,220评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,550评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,697评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,360评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,002评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,782评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,010评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,433评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,587评论 2 350

推荐阅读更多精彩内容