(AccessibilityService) Android 辅助功能笔记

最近因为项目的需要(在某个界面需要自动的点击某个按钮),所以接触了关于辅助功能的开发。刚开始的时候根本没有想到可以用辅助功能来帮助实现这个需求,一直在看关于屏幕监听和模拟点击的一些资料。后来通过有经验的同事的介绍,发现可以使用辅助功能来实现我这一需求。话不多说,开始介绍这个辅助功能(AccessibilityService):


1. 创建自己的辅助功能类:

编写自己的服务类,需要继承AccessibilityService类。

对于一些需要重载的方法的介绍:

onServiceConnected();

系统会在成功连接上你的服务的时候调用这个方法,在这个方法里你可以做一下初始化工作,例如设备的声音震动管理,也可以调用setServiceInfo()进行配置工作。

onAccessibilityEvent();

通过这个函数可以接收系统发送来的AccessibilityEvent,接收来的AccessibilityEvent是经过过滤的,过滤是在配置工作时设置的。

onInterrupt();

这个在系统想要中断AccessibilityService返给的响应时会调用。在整个生命周期里会被调用多次。

onUnbind(Intent intent);

在系统将要关闭这个AccessibilityService会被调用。在这个方法中进行一些释放资源的工作。

1.1 配置:

对于辅助功能类的配置有两种方式:

(1)onServiceConnected()中初始化的方式:

配置service_info

(2)使用在manifest中添加meta-data的方式(Android 4.0 开始 ——可以参见我在注册中的代码片段)

在value文件夹中,添加一个xml文件夹(名字应该是可以自定义的,个人没有试过),并在其中添加一个accessibilityservice.xml或者任何你喜欢的名字。可参见下图:

配置service_info

建议将一些不可动态更改的服务配置写到xml文件中。

可以看到上边使用了部分的参数,都是比较常用的一些参数配置,下面来介绍下这些参数的作用:

Event types(android:accessibilityEventTypes  /  info.eventTypes)

简单说两个常用的:(具体的可以参照API真的太多了)

typeAllMask  /  AccessibilityEvent.TYPES_ALL_MASK:全局事件响应

typeViewClicked  /  AccessibilityEvent.TYPE_VIEW_CLICKED :点击事件

Feedback Types(android:accessibilityFeedbackType  /  info.feedbackType )

feedbackGeneric  /  AccessibilityServiceInfo.FEEDBACK_GENERIC : 通用的反馈

feedbackAudible  /  AccessibilityServiceInfo.FEEDBACK_AUDIBLE : 声音反馈

feedbackSpoken  /  AccessibilityServiceInfo.FEEDBACK_SPOKEN  :  语音反馈

CanRetrieveWindow  (android:canRetrieveWindowContent  / info.getCanRetrieveWindowContent()

从一个AccessibilityEvent中调查完全视图层级的能力隐式地暴露私有用户信息给你的无障碍服务。出于这个原因,你的服务必须通过无障碍服务配置XML文件请求这个级别的访问权,通过包含canRetrieveWindowContent属性和设置它为true。如果你不在你的服务配置xml文件中包含这个设置,那么对getSource()的调用会失败。

PackageNames (android:packageNames=  /  info.packageNames)

需要服务监听的包名,中间可以用","分隔开。

notificationTimeout(android:notificationTimeout  /  info.notificationTimeout)

响应时间的设置

1.2 Service类中对事件的拦截处理

这个部分主要在onAccessibilityEvent()中处理回调返回的AccessibilityEvent。

主要需要了解的有:

AccessibilityNodeInfo(findAccessibilityNodeInfosByViewId,findAccessibilityNodeInfosByText)

AccessibilityEvent(eventType)

(1)AccessibilityEvent:

首先介绍AccessibilityEvent:

This class represents accessibility events that are sent by the system when something notable happens in the user interface.(在用户交互使用时系统返回的event事件)

方法:

getSource() :

Gets the AccessibiltyNodeInfo of the event source.

当前event的节点信息

顺便说下getRootInActiveWindow()

Gets the root node in the currently active window if this service can retrieve window content.

中文的翻译应该是获取到当前活跃中本服务的可检索到窗口的根节点

getSource()  约等于? AccessibilityService.getRootInActiveWindow();(我输出过两个NodeInfo的child个数,不太一致,有个数差。)

It is a client responsibility to recycle the received info by calling AccessibilityNodeInfo.recycle() to avoid creating of multiple instances.

为避免创建重复的实例通过recycle方法回收掉nodeInfo(我们自己手动去回收)

eventType :(常用)

TYPE_NOTIFICATION_STATE_CHANGED

represents the event of change in the content of a window. This change can be adding/removing view, changing a view size, etc.

基本窗口view的变化都可以使用这个type来监听

TYPE_WINDOW_STATE_CHANGED

Represents the event of opening a Pop,Menu,Dialog etc.

打开popupwindow,菜单,对话框时候会触发

TYPE_WINDOW_CONTENT_CHANGED

Represents the event of changing the content of a window and more specifically the sub-tree rooted at the event's source.

更加精确的代表了基于当前event.source中的子view的内容变化

TYPE_WINDOWS_CHANGED

Represents the event change in the windows shown on the screen.

窗口的变化

AccessibilityEvent

(2)AccessibilityNodeInfo:

我觉得是辅助功能中最重要的的一个内容,也是最坑的地方到来了。

关于节点这个问题应该是没有太多的可说的地方,但是呢,出问题出的最多的地方也是这里。

先看下怎么获取NodeInfo:

AccessibilityNodeInfo mNodeInfo = getRootInActiveWindow();

AccessibilityNodeInfo mNodeInfo= event.getSource();

两种获取方式,之前我也提过,有时候两种方式获取的childNode个数不一致,挨了个球,我都不知道是肿么回事,有了解原理的大大请给我解解惑吧。

好的接下来我们来查找我们需要做操作的view,在NodeInfo中,默认提供了两个方法来查找我们需要操作的对象:(开始重头戏)

findAccessibilityNodeInfosByViewId(String str)

findAccessibilityNodeInfosByText(String str)

(1)先说上一个方法:findAccessibilityNodeInfosByViewId(String id)

List <AccessibilityNodeInfo> listNodes = mNodeInfo.findAccessibilityNodeInfosByViewId("id");

好的,关于这个ID我真的想说说事,每个API不同,同一个对象的ID可能不同:So,做国际化的时候,噩梦来了,为什么在大Samsung上边能够找到并操作这个node对象,在LG上就不可以捏....

OK,这里就来到了我们的关于node对象的id问题了,放心,Google会让你有解决方法的。(不过就是要累死你,累死你累死你)隆重的来到Hierarchy View。(这里可以百度,大概就是在Android Device Monitor中打开这个View,查看对应界面的view的ID信息)。

关于真机不能连接Hierarchy View,可以看下我另一篇文章《AccessibilityService 获取View的Id》

好了,好多同学以为知道id就完了,呵呵,too young to naive。

id的格式大概是这样的"com.android.settings:id/force_stop_button"(这里以设置界面的强制停止按钮作为范例),请注意加粗的部分,WTF我怎么知道这个前边是神马...

不要惊慌,注意看这里:

聪明的小朋友了解了吧。哈哈不多说,没懂就多看看图。

(2)说完了findById,我们接着说findAccessibilityNodeInfosByText(String text)

List listNodes = mNodeInfo.findAccessibilityNodeInfosByText("text");

看了上边的findById之后,这个方法也简单多了吧。没有那么坑,只是做中文系统的时候,直接就可以看图写关键词。所以就不多说了。

(3)关于node的使用:

node.performAction(AccessibilityNodeInfo.ACTION_CLICK);

点击事件简单至极,一看就明白了。

需要其他的操作,只需要看看API,换换ACTION啦。

(4)全局按钮的操作

performGlobalAction(AccessibilityService.GLOBAL_ACTION_BACK);

同上。全局的操作是在service做出的action,和node没有太大的关系。

2. 注册:

AccessibilityService,从名字上来看,有经验的小朋友就不难看出来,他是一个service,(内心独白:屁话,是个猿都能看出来,鄙视...)那对于他的注册,就不需要多说了,这里简要的将manifest中service注册的一些参数做出说明:

name:对应的是自定义service的包名

label:对应了在系统辅助功能开关界面中,你的service的名字(例如:手机管家等)

description :则是点击对应的服务进入开关界面后,该服务的简介

permission:应该都不陌生,对应的权限

(亦可在service中单独写出来

<uses-permission android:name="android.permission.BIND_ACCESSIBILITY_SERVICE">)

intent-filter:指定了执行的组件为辅助功能类

3. 其他的一些辅助判断的方法:

3.1是否开启辅助功能的判断

3.2 跳转到辅助功能界面,开启辅助功能

总结:

在辅助功能开发中,初次开发的朋友可能会遇到的一些难点(我觉得我第一次开发的时候最难得就是找viewId)

1、获取需要操作的viewId

之前也提到过可以使用hierarchy View来查找对应的viewId,但是在实际开发中,很多手机是没有办法连接server进行dump view的,在这个时候,我们其实可以在AccessibiltiyService的配置中添加一个flag。对应的属性是:android:accessibilityFlags="flagReportViewIds"。在代码中我们就可以通过node节点来getViewIdResourceName()获取对应的节点的id。

2、获取到id后,查找到需要操作的node

根据id查找节点的方法上边也有介绍过,需要注意的是,id的格式,对于packageName我们可以通过getPackageName()方法获取。

最后,祝大家都能够愉快的进行辅助功能的开发工作。

PS.在网上搜索辅助功能的话,都会出现一些关于微信抢红包的插件。没错,微信抢红包的插件就是使用了我们今天要介绍的辅助功能来开发的。

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

推荐阅读更多精彩内容