Android：AccessibilityService辅助功能基础使用(附微信抢红包教程)

2024-07-17 16:46| 来源: 网络整理| 查看: 265

辅助功能（AccessibilityService）是一个Android系统提供的一种服务，继承自Service类。AccessibilityService运行在后台，能够监听系统发出的一些事件(AccessibilityEvent)，这些事件主要是UI界面一系列的状态变化，比如按钮点击、输入框内容变化、焦点变化等等，查找当前窗口的元素并能够模拟点击等事件。官方文档

这个系统功能主要为一些残障人士用户设计，他们由于各种原因比如视力、年龄、身体等因素导致使用Android设备困难。但是很多android开发者用这个功能来做一些不正常的操作，当然这种极客精神，只要不非法，我不认为是错误的。

开始使用

AccessibilityService使用非常非常简单。

1 首先新建一个类MyAccessibilityService并继承AccessibilityService

代码如下：

代码语言：javascript复制// 代码片段1 class MyAccessibilityService : AccessibilityService() { override fun onInterrupt() { } override fun onServiceConnected() { super.onServiceConnected() // val serviceInfo = AccessibilityServiceInfo() // serviceInfo.eventTypes = AccessibilityEvent.TYPES_ALL_MASK//typeNotificationStateChanged|typeWindowStateChanged|typeWindowContentChanged // serviceInfo.feedbackType = AccessibilityServiceInfo.FEEDBACK_GENERIC//feedbackGeneric // serviceInfo.packageNames = arrayOf("com.tencent.mm")//com.tencent.mm // serviceInfo.notificationTimeout = 100 // serviceInfo.flags = AccessibilityServiceInfo.DEFAULT //// //android:canRetrieveWindowContent="true" //// serviceInfo.canRetrieveWindowContent = true // setServiceInfo(serviceInfo) } override fun onAccessibilityEvent(event: AccessibilityEvent?) { dispatchEvent(event, rootInActiveWindow) } }

onAccessibilityEvent(AccessibilityEvent event)及onInterruput()这两个方法是抽象方法，必须重写。常用API介绍：

onServiceConnected()：做一些初始化的操作 onInterrupt ()：AccessibilityService被中断时会调用，在整个生命周期里会被调用多次。 onUnbind(intent: Intent)：你可以做一些初始化的操作 onServiceConnected：AccessibilityService将要关闭时会被调用，这个方法做一些释放资源的操作。 onAccessibilityEvent(event: AccessibilityEvent?)：核心API，AccessibilityEvent事件的回调函数，系统通过sendAccessibiliyEvent()方法发送AccessibilityEvent事件到这里 getRootInActiveWindow()：则会返回当前活动窗口的根结点，查找View的时候用到它 findFoucs(int falg)：查找拥有特定焦点类型的控件 disableSelf()：禁用当前服务2 辅助类的声明与配置

AccessibilityService继承Service，因此也需要在AndroidManifest.xml中声明：

代码语言：javascript复制// 代码片段2

注意需要加上BIND_ACCESSIBILITY_SERVICE权限。代码片段2中的meta部分是AccessibilityService的配置信息，这是android 4.0后才支持的，代码如下：

代码语言：javascript复制// 代码片段3

设置配置信息还有第二种方法，就是在onServiceConnected()方法中使用代码设置，如代码片段1中的注释部分所示。这里的配置有很多属性，我们只研究其中的6个：

android:packageNames：指定辅助服务监听哪些应用发出事件，多个应用包名之间用逗号分隔，如果不填，则监听手机上所有应用。例如我们现在要利用辅助点击做app的自动安装功能，取值com.android.packageinstaller。如果只关注微信发出的事件，那么取值com.tencent.mm。 android:accessibilityEventTypes：辅助服务监听的事件类型，例如TYPE_VIEW_FOCUSED、TYPE_VIEW_CLICKED 、TYPE_WINDOW_STATE_CHANGED、TYPE_NOTIFICATION_STATE_CHANGED等等，如果监听全部事件，就取值typeAllMask android:accessibilityFlags：辅助服务额外的flag信息，例如FLAG_REPORT_VIEW_IDS可以使回调的事件带上view的ID。 android:accessibilityFeedbackType：事件的反馈类型，例如通用反馈FEEDBACK_GENERIC、声音反馈FEEDBACK_AUDIBLE、语音反馈FEEDBACK_SPOKEN等。 android:notificationTimeout：两个同样类型的监听事件发给辅助类的最小时间间隔 android:canRetrieveWindowContent：是否可以获取窗口内容，一般设置为true处理监听到的事件

前面就是使用辅助类的全部了，怎么样，是不是很简单？但是处理监听到的事件就有点麻烦了。我在github上写了一个微信抢红包的的开源项目，代码地址，我结合这个git库的代码解释下如何处理监听事件。

处理事件的入口是onAccessibilityEvent(event: AccessibilityEvent?)方法，我写了一个分发事件的类：DispatchEvent.kt，里面的方法dispatchEvent(event: AccessibilityEvent?, rootInActiveWindow: AccessibilityNodeInfo?)负责分发事件，代码如下：

代码语言：javascript复制// 代码片段4 fun dispatchEvent(event: AccessibilityEvent?, rootInActiveWindow: AccessibilityNodeInfo?) { val pkgName = event?.packageName.toString() val eventType = event?.getEventType() Log.i(TAG, "pkgName:${pkgName} eventType:${eventType} className:${event?.getClassName().toString()} " + "event.text:${listToString(event?.text)} event?.getContentChangeTypes():${event?.getContentChangeTypes()}\n") when (eventType) { AccessibilityEvent.TYPE_NOTIFICATION_STATE_CHANGED -> com.example.zhouzhihui.accessibilitydemo.access.packet.handleNotification(event)//64 1-->click AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED, AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED -> {//32 2048 val className = event.getClassName().toString() if (className == "com.tencent.mm.ui.LauncherUI" || className == "com.tencent.mm.ui.mogic.WxViewPager" || className == "android.widget.EditText"/* || className == "android.widget.ListView"*/) { com.example.zhouzhihui.accessibilitydemo.access.packet.searchPacket(rootInActiveWindow) } else if (className == "com.tencent.mm.plugin.luckymoney.ui.LuckyMoneyReceiveUI") {//com.tencent.mm.plugin.luckymoney.ui.LuckyMoneyPrepareUI com.example.zhouzhihui.accessibilitydemo.access.packet.openPacket(rootInActiveWindow) } else if (className == "com.tencent.mm.plugin.luckymoney.ui.LuckyMoneyDetailUI") { com.example.zhouzhihui.accessibilitydemo.access.packet.closePacket(rootInActiveWindow) } } } if (event?.getContentChangeTypes() == AccessibilityEvent.CONTENT_CHANGE_TYPE_TEXT) { Withdraw().withDraw(event, rootInActiveWindow)//防消息撤回 } rootInActiveWindow?.recycle()//避免重复创建实例通过recycle方法回收掉nodeInfo（我们自己手动去回收） }

代码片段4事件被分发成四个分流：handleNotification(event: AccessibilityEvent?)、searchPacket(rootInActiveWindow: AccessibilityNodeInfo?)、openPacket(rootInActiveWindow: AccessibilityNodeInfo?)、closePacket(rootInActiveWindow: AccessibilityNodeInfo?)，这四个方法的处理逻辑在Packet.kt类中。

handleNotification(event: AccessibilityEvent?)。当eventType == AccessibilityEvent.TYPE_NOTIFICATION_STATE_CHANGED == 64的时候执行这个事件流，这个事件表示监听到了通知栏事件，微信处在后台的时候来了聊天消息，就会出发这个事件，我们的方法检测通知内容是否包含为本"[微信红包]"，如果包含就表示收到了红包消息，就执行它附带的PendingIntent，然后就会跳到相应的聊天页面。searchPacket(rootInActiveWindow: AccessibilityNodeInfo?)。当eventType == AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED == 32或者eventType == AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED == 2048的时候执行这个事件流。32表示窗口状态发生了变化，比如微信的主页"com.tencent.mm.ui.LauncherUI"从后台调到前台就会触发这个事件，并且它附带的className就是"com.tencent.mm.ui.LauncherUI"；2048表示窗口的内容发生了变化，比如你在微信的第一个tab页面，这时候来了个聊天消息，就会触发这个事件，附带的className是android.widget.ListView，嗯，没错，微信竟然还是在用ListView这个过时的组件而不是RecyclerView。我们捕捉到这个事件后调用searchPacket()方法，顾名思义，这个方法要搜索红包并点击。我们传给它的参数通过API AccessibilityService.getRootInActiveWindow()获取的，我有点搞不懂这个API和AccessibilityEvent.getSource()有什么区别，前者是辅助服务调用的，应该是窗口的根节点，后者是监听到的某个事件获取的，应该是这个事件的源节点，我用Log显示大部分时候两者是一致的。searchPacket方法通过递归查找红包，当找到某个节点内容包含“领取红包”就终止递归，然后循环查找这个节点和它的父节点的第一个能够点击的节点，执行点击事件rootInActiveWindow.performAction(AccessibilityNodeInfo.ACTION_CLICK)就能自动点击红包。openPacket(rootInActiveWindow: AccessibilityNodeInfo?)。条件同上，当eventType == AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED == 32或者eventType == AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED == 2048的时候执行这个事件流。通过上面的searchPacket我们搜索到了红包并点击了，这时会出现红包领取页面，我们这里openPacket方法是要找到领取红包的节点并执行这个节点的点击事件进行领取。关键是如何找到这个节点，一种方法是通过ViewId，API AccessibilityNodeInfo.getViewIdResourceName()可以获取这个节点的id，但是你需要事先知道这个节点的id，而且辅助的配置标记必须是android:accessibilityFlags="flagReportViewIds"才能获取节点的id，可以使用Android Device Monitor或者Layout Inspector查看id，也可以直接把节点的id打印出来进行查看对比，但是微信的程序员经常改变id，我不认为这个方法是可靠的，我的方法是如果满足条件(rootInActiveWindow?.isClickable == true && rootInActiveWindow?.className?.contains("android.widget.Button") == true)就认为这个节点是领取红包的按钮，然后执行点击事件：rootInActiveWindow?.performAction(AccessibilityNodeInfo.ACTION_CLICK)。closePacket(rootInActiveWindow: AccessibilityNodeInfo?)。条件同上，当eventType == AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED == 32或者eventType == AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED == 2048的时候执行这个事件流。这个方法是为了找到左上角的返回按钮，进行点击返回聊天页面。这个也不是通过id的方式，而是如果满足(rootInActiveWindow?.className == "android.widget.LinearLayout" && rootInActiveWindow?.isClickable && TextUtils.isEmpty(rootInActiveWindow?.text))就认为是左上角的返回节点。

下面贴出代码：

代码语言：javascript复制// 代码片段5 fun handleNotification(event: AccessibilityEvent?) { if (event == null) { return } val texts = event.text if (!texts.isEmpty()) { for (text in texts) { val content = text.toString() if (content.contains("[微信红包]")) { if (event.parcelableData != null && event.parcelableData is Notification) { val notification = event.parcelableData as Notification val pendingIntent = notification.contentIntent try { pendingIntent.send() } catch (e: PendingIntent.CanceledException) { e.printStackTrace() } } } } } } fun searchPacket(rootInActiveWindow: AccessibilityNodeInfo?) { Log.i(TAG, "searchPacket node: ${rootInActiveWindow} childCount: ${rootInActiveWindow?.childCount} idName: ${rootInActiveWindow?.getViewIdResourceName()}") if (rootInActiveWindow?.text.toString() == "领取红包") { if (rootInActiveWindow?.isClickable == true) { rootInActiveWindow.performAction(AccessibilityNodeInfo.ACTION_CLICK) } else { var parent: AccessibilityNodeInfo? = rootInActiveWindow?.getParent() while (parent != null) { if (parent.isClickable) { parent.performAction(AccessibilityNodeInfo.ACTION_CLICK) break } parent = parent.parent } } } else { for (i in 0 until (rootInActiveWindow?.childCount ?: -1)) { searchPacket(rootInActiveWindow?.getChild(i)) } } } fun openPacket(rootInActiveWindow: AccessibilityNodeInfo?) { Log.i(TAG, "openPacket node: ${rootInActiveWindow} childCount: ${rootInActiveWindow?.childCount} idName: ${rootInActiveWindow?.getViewIdResourceName()}") if (rootInActiveWindow?.isClickable == true && rootInActiveWindow?.className?.contains("android.widget.Button") == true) { rootInActiveWindow?.performAction(AccessibilityNodeInfo.ACTION_CLICK) } // node?.traversalAfter for (i in 0 until (rootInActiveWindow?.childCount ?: -1)) { openPacket(rootInActiveWindow?.getChild(i)) } } fun closePacket(rootInActiveWindow: AccessibilityNodeInfo?) { Log.i(TAG, "closePacket node: ${rootInActiveWindow} childCount: ${rootInActiveWindow?.childCount} idName: ${rootInActiveWindow?.getViewIdResourceName()}") if (rootInActiveWindow?.className == "android.widget.LinearLayout" && rootInActiveWindow?.isClickable && TextUtils.isEmpty(rootInActiveWindow?.text)) { //className: android.widget.LinearLayout; text: null; error: null; maxTextLength: -1; contentDescription: null; viewIdResName: com.tencent.mm:id/ho; rootInActiveWindow?.performAction(AccessibilityNodeInfo.ACTION_CLICK) return } for (i in 0 until (rootInActiveWindow?.childCount ?: -1)) { closePacket(rootInActiveWindow?.getChild(i)) } }

此外，在MainActivity里面，还有判断服务是否开启的逻辑，如果没有开启，则可以点击跳转带开启页面：

代码语言：javascript复制// 代码片段6 MainActivity.kt class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) hello.also { val isOn = isAccessibilityServiceOn() it.text = if (isOn) "服务已经开启" else "点击开启服务" it.isEnabled = !isOn it.setOnClickListener { startActivity(Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS)) } } } }代码语言：javascript复制// 代码片段7 Tools.kt val TAG = AccessibilityService::class.java.simpleName fun listToString(list : List?): String { var result = StringBuilder("") list?.forEach { result.append("${it.toString()}\t") } return result.toString() } fun isPrePagePacket(prePageName: String): Boolean { return prePageName == "com.tencent.mm.plugin.luckymoney.ui.LuckyMoneyReceiveUI" || prePageName == "com.tencent.mm.plugin.luckymoney.ui.LuckyMoneyDetailUI" } fun Context.isAccessibilityServiceOn(): Boolean { var service = "${packageName}/${MyAccessibilityService::class.java.canonicalName}" var enabled = Settings.Secure.getInt(applicationContext.contentResolver, Settings.Secure.ACCESSIBILITY_ENABLED) var splitter = TextUtils.SimpleStringSplitter(':') if (enabled == 1) { var settingValue = Settings.Secure.getString(applicationContext.contentResolver, Settings.Secure.ENABLED_ACCESSIBILITY_SERVICES) if (settingValue != null) { splitter.setString(settingValue) while (splitter.hasNext()) { var accessibilityService = splitter.next() if (accessibilityService.equals(service, ignoreCase = true)) { return true } } } } return false }

自动领取红包的代码写完了，运行安装到手机上，还差最后一步了，就是在手机的“设置”里面把刚刚装上的应用的服务开启，我的小米手机开启方法如图所示：

最后

好了，本文是对AccessibilityService简单的应用，如果你觉得文章写得不错就给个赞呗？如果你有更好的想法和项目欢迎留言。一定会认真查询，修正不足。谢谢！

希望读到这的您能转发分享和关注一下我，以后还会更新技术干货，谢谢您的支持！

【本文地址】

公司简介

联系我们

今日新闻

推荐新闻

专题文章