最近在做一个基于无障碍自动刷短视频的APP,需要支持用任意蓝牙遥控器远程控制, 把无障碍服务流程大致研究了一下,从下面3个部分做一下小结。
1、需要可调整自动上滑距离和速度以适配不同的屏幕和应用
智能适配99%机型,滑动参数可自由调节。
默认的距离和速度可能在个别手机上无法达到滑屏的要求,表现就是屏幕可见滑动了下,但还是停留回当前界面。所以需要给用户一种自定义调整的方式,这里以【辅助触控】APP为例,提供了屏幕配置的实现,可以自行拖动滑动起始点,然后调整滑动参数。


编辑屏幕的时候支持增删按键映射(12个可编程功能键 (F1-F12)),并自定义如下参数:
- ➕ 单击/双击/连击/长按
- ⚙️ 自定义间隔(0.1-30秒)
- ⏱️ 按压停留时长设置
支持手势轨迹定制如下参数:
- 📍 起点/终点坐标设置
- ⏲️ 自定义间隔(3-30秒)和滑动速度
- 📐 四向滑动独立配置
在定义好按键映射后,还可以对其进行组合控制,编写一组相关动作然后执行。

其中还可以进一步定义文本识别后要执行的动作,比如单击文本节点、返回、上滑等。
2、监听TYPE_WINDOW_STATE_CHANGED事件,在图形验证码出现时停止,需要能识别出带有关键文本的视图元素
比如支付宝看视频领红包活动,会一定机率跳出图形验证码,需要用户手动点选,如果此界面继续滑屏,很容易被系统识别到正在进行自动化脚本刷屏。需要对界面内容识别,比如文本 "请依次点击下面的图案"。
在自动滑屏期间检测到该事件,说明有窗口焦点切换,一般就是切换到了不同的窗口,比如 Dialog、PopupWindow等。有可能就是这个验证框,这时候我们需要拿到getRootInActiveWindow(),然后通过无障碍API findAccessibilityNodeInfosByText找出包含上面文本的Node。
Kotlin
//这里是我们要找的可能的文本
val ocrTexts = listOf("请在下图依次点击")
for(ocrTry in 0 until 4) {
for (text in ocrTexts) {
//找包含text的那些节点,这些节点要么是能呈现指定文本(text、hint)的视图,要么是包含指定内容描述(content description)的视图
var nodes = rootInActiveWindow?.findAccessibilityNodeInfosByText(text)
nodes?.forEach { nodeInfo ->
//找到了验证框,停止滑屏,并发出声音和震动提示用户,需要手动验证。
autoRepeatIntervalJob?.cancel()
playBeepSoundAndVibrate(5000)
return
}
}
if (ocrTry < 3) {
//延迟一下,有可能文本内容还没加载
Thread.sleep(500)
}
}
在循环中每次我们都重新获取rootInActiveWindow, 否则可能获取到的不是当前界面,不用担心性能问题,只要没有新的TYPE_WINDOW_STATE_CHANGED事件发生,都会使用缓存。所以每次获取的好处就是即使事件发生了,我下一个循环就能得到新界面。
实测发现,如下图支付宝这个验证框使用findAccessibilityNodeInfosByText居然找不到

难道他是图片?带着怀疑我用uiautomatorviewer看了下布局,发现只是一个TextView, 文本也是"请在下图依次点击",和我们检索字符串一样,只是它的ImportantForAccessibility属性是false, 我们的AccessibilityService的config里也添加了flagIncludeNotImportantViews(包括不重要的视图),照理应该能找到并返回。然后我又尝试了下遍历的方式:
Kotlin
fun AccessibilityService.findTextByTraversal(text: String, include: Boolean = false): List<AccessibilityNodeInfo> {
val result = mutableListOf<AccessibilityNodeInfo>()
traverseNodes(result, rootInActiveWindow, text, include)
return result
}
private fun traverseNodes(
result: MutableList<AccessibilityNodeInfo>,
node: AccessibilityNodeInfo?,
searchText: String,
include: Boolean = false,
) {
node?.let {
if (node.text != null && node.text.isNotEmpty()) {
if (include && node.text.contains(searchText)) {
result.add(node)
} else if (node.text == searchText) {
result.add(node)
}
if (DebugUtils.DEBUG) DebugUtils.logD(TAG, "traverseNodes find $node")
}
for (i in 0 until node.childCount) {
traverseNodes(result, node.getChild(i), searchText, include)
}
}
}
竟然能找到这个node,这样的话先修改一下逻辑,优先使用findAccessibilityNodeInfosByText,找不到再递归找。
第3部分我们通过源码梳理一下AccessibilityService和AccessibilityManagerService 之间的通信过程,尝试分析一下findAccessibilityNodeInfosByText是怎样进行查找的?
3、AccessibilityService和AccessibilityManagerService 之间的通信过程
参考源码
https://xrefandroid.com/android-11.0.0_r48/
首先我们需要简单了解一下AccessibilityService启动流程。
AccessibilityService启动流程
在SystemServer主进程服务启动阶段,AccessibilityManagerService ( AMS**)作为系统服务被初始化,**负责管理全局无障碍服务生命周期及事件分发。
java
// frameworks/base/services/java/com/android/server/SystemServer.java
private static final String ACCESSIBILITY_MANAGER_SERVICE_CLASS =
"com.android.server.accessibility.AccessibilityManagerService$Lifecycle";
private void startOtherServices(@NonNull TimingsTraceAndSlog t) {
...
try {
mSystemServiceManager.startService(ACCESSIBILITY_MANAGER_SERVICE_CLASS);
} catch (Throwable e) {
reportWtf("starting Accessibility Manager", e);
}
}
实例化AccessibilityManagerService$Lifecycle对象并调用其onStart()

将AMS发布出来,之后就可以通过Context.getSystemService(Context.ACCESSIBILITY_SERVICE)获取对应的AccessibilityManager来和AMS通信。
AMS init初始化时注册 PackageMonitor 监听应用安装/卸载事件,动态维护已注册的无障碍服务列表,注册ACTION_USER_PRESENT读取所有已安装应用的无障碍服务信息查询所有已安装应用中的无障碍服务信息:
//frameworks/base/services/accessibility/java/com/android/server/accessibility/AccessibilityManagerService.java


其中只要有somethingChanged = true, 比如下面这个,读取到已安装应用发生了变更

则调用onUserStateChangedLocked更新相关信息:

包括绑定App的AccessibilityService, 创建一个AccessibilityServiceConnection来绑定服务和完成两者之间的通信。


绑定成功后,会回调onServiceConnected(ComponentName componentName, IBinder service)

我们知道Service的绑定过程是,被绑定的服务会启动,然后在onBind(Intent)返回一个IBinder对象给绑定者, 绑定者在onServiceConnected中可以获取到一个用于和Service进行IPC通信的接口对象IBinder。
比如前面提到的TYPE_WINDOW_STATE_CHANGED 事件,传递过程为:
AMS sendAccessibilityEvent(AccessibilityEvent event, int userId) -> AMSnotifyAccessibilityServicesDelayedLocked(AccessibilityEvent event, boolean isDefault) -> AccessibilityServiceConnection.notifyAccessibilityEvent(event) -> mServiceInterface.onAccessibilityEvent(event, serviceWantsEvent) ···IPC···> IAccessibilityServiceClientWrapper.onAccessibilityEvent(event, serviceWantsEvent) -> AccessibilityService.onAccessibilityEvent(event)
上面是AMS到AccessibilityService的通信,AccessibilityService到AMS则是通过AccessibilityInteractionClient。
前面已经提到在onBind回调的时候,我们返回了一个IAccessibilityServiceClientWrapper IBinder给AMS, AMS在绑定服务成功后拿到service IBinder,调用了initializeService,将AMS端的AccessibilityServiceConnection回传给了AccessibilityService,如下代码所示:
java
public void onServiceConnected(ComponentName componentName, IBinder service) {
...
mServiceInterface = IAccessibilityServiceClient.Stub.asInterface(service); //service就是IAccessibilityServiceClientWrapper IBinder
...
mMainHandler.sendMessage(obtainMessage(AccessibilityServiceConnection::initializeService, this));
...
}
private void initializeService() {
...
serviceInterface.init(this, mId, mOverlayWindowTokens.get(Display.DEFAULT_DISPLAY));
...
}
//frameworks/base/core/java/android/accessibilityservice/AccessibilityService$IAccessibilityServiceClientWrapper
public void init(IAccessibilityServiceConnection connection, int connectionId, IBinder windowToken) {
Message message = mCaller.obtainMessageIOO(DO_INIT, connectionId, connection, windowToken);
mCaller.sendMessage(message);
}
public void executeMessage(Message message) {
...
case DO_INIT: {
mConnectionId = message.arg1;
SomeArgs args = (SomeArgs) message.obj;
IAccessibilityServiceConnection connection = (IAccessibilityServiceConnection) args.arg1;
IBinder windowToken = (IBinder) args.arg2;
args.recycle();
if (connection != null) {
//关联 IAccessibilityServiceConnection
AccessibilityInteractionClient.getInstance().addConnection(mConnectionId, connection);
mCallback.init(mConnectionId, windowToken);
mCallback.onServiceConnected();
}
...
}
...
}
IAccessibilityServiceClientWrapper 将AMS传来的IAccessibilityServiceConnection 添加到 AccessibilityInteractionClient 中缓存起来,后续用来和 AMS 通信。
到这里我们的AccessibilityService与AMS的通道就建好了:
AccessibilityService -> AccessibilityInteractionClient -> IAccessibilityServiceConnection ··· IPC ··· **>**AccessibilityServiceConnection -> AMS
现在回头来看findAccessibilityNodeInfosByText, 一般我们需要先getRootInActiveWindow 获取root 节点。
getRootInActiveWindow 获取root 节点
java
public AccessibilityNodeInfo getRootInActiveWindow() {
return AccessibilityInteractionClient.getInstance().getRootInActiveWindow(mConnectionId);
}
//AccessibilityInteractionClient
public AccessibilityNodeInfo getRootInActiveWindow(int connectionId) {
//这里使用固定的ACTIVE_WINDOW_ID和ROOT_NODE_ID,在AMS那边会对应到当前可交互窗口的root,
return findAccessibilityNodeInfoByAccessibilityId(connectionId,
AccessibilityWindowInfo.ACTIVE_WINDOW_ID, AccessibilityNodeInfo.ROOT_NODE_ID, false, AccessibilityNodeInfo.FLAG_PREFETCH_DESCENDANTS, null);
}
public @Nullable AccessibilityNodeInfo findAccessibilityNodeInfoByAccessibilityId(
int connectionId, @NonNull IBinder leashToken, long accessibilityNodeId,
boolean bypassCache, int prefetchFlags, Bundle arguments) {
if (leashToken == null) {
return null;
}
int windowId = -1;
try {
//获取前面关联的缓存在线程中的IAccessibilityServiceConnection
IAccessibilityServiceConnection connection = getConnection(connectionId);
if (connection != null) {
windowId = connection.getWindowIdForLeashToken(leashToken);
} else {
if (DEBUG) {
Log.w(LOG_TAG, "No connection for connection id: " + connectionId);
}
}
} catch (RemoteException re) {
Log.e(LOG_TAG, "Error while calling remote getWindowIdForLeashToken", re);
}
if (windowId == -1) {
return null;
}
return findAccessibilityNodeInfoByAccessibilityId(connectionId, windowId,
accessibilityNodeId, bypassCache, prefetchFlags, arguments);
}
public AccessibilityNodeInfo findAccessibilityNodeInfoByAccessibilityId(int connectionId,
int accessibilityWindowId, long accessibilityNodeId, boolean bypassCache,
int prefetchFlags, Bundle arguments) {
...
//向AMS connection发请求, 传入AccessibilityInteractionClient自身作为callback,用于接收结果回调
packageNames = connection.findAccessibilityNodeInfoByAccessibilityId(
accessibilityWindowId, accessibilityNodeId, interactionId, this,
prefetchFlags, Thread.currentThread().getId(), arguments);
...
//等待AMS 返回结果
List<AccessibilityNodeInfo> infos = getFindAccessibilityNodeInfosResultAndClear(interactionId);
...
}
//frameworks/base/services/accessibility/java/com/android/server/accessibility/AbstractAccessibilityServiceConnection.java
public String[] findAccessibilityNodeInfoByAccessibilityId(
int accessibilityWindowId, long accessibilityNodeId, int interactionId,
IAccessibilityInteractionConnectionCallback callback, int flags,
long interrogatingTid, Bundle arguments) throws RemoteException {
...
// 解析当前的windowId
resolvedWindowId = resolveAccessibilityWindowIdLocked(accessibilityWindowId);
...
//找到当前窗口和AMS之间的交互连接对象
connection = mA11yWindowManager.getConnectionLocked(mSystemSupport.getCurrentUserIdLocked(), resolvedWindowId);
...
//将请求通过IPC发给连接的远程端
connection.getRemote().findAccessibilityNodeInfoByAccessibilityId(
accessibilityNodeId, partialInteractiveRegion, interactionId, callback,
mFetchFlags | flags, interrogatingPid, interrogatingTid, spec, arguments);
...
}
这里经过查阅源码,发现connection是应用通过ViewRootImpl创建新窗口(如 Activity、Dialog、PopupWindow 等)时,会通过IPC向AMS进行**addAccessibilityInteractionConnection()**调用,从而注册窗口与AMS之间的交互连接对象,
connection.getRemote()就是这个对象 ,如下源码所示的AccessibilityInteractionConnection:
java
//frameworks/base/core/java/android/view/ViewRootImpl.java
public void setView(View view, WindowManager.LayoutParams attrs, View panelParentView,
int userId) {
...
if (mAccessibilityManager.isEnabled()) {
mAccessibilityInteractionConnectionManager.ensureConnection();
}
...
}
final class AccessibilityInteractionConnectionManager
implements AccessibilityStateChangeListener {
...
public void ensureConnection() {
final boolean registered = mAttachInfo.mAccessibilityWindowId
!= AccessibilityWindowInfo.UNDEFINED_WINDOW_ID;
if (!registered) {
mAttachInfo.mAccessibilityWindowId =
mAccessibilityManager.addAccessibilityInteractionConnection(mWindow,
mLeashToken,
mContext.getPackageName(),
new AccessibilityInteractionConnection(ViewRootImpl.this));
}
}
...
}
static final class AccessibilityInteractionConnection
extends IAccessibilityInteractionConnection.Stub {
private final WeakReference<ViewRootImpl> mViewRootImpl;
AccessibilityInteractionConnection(ViewRootImpl viewRootImpl) {
mViewRootImpl = new WeakReference<ViewRootImpl>(viewRootImpl);
}
...
@Override
public void findAccessibilityNodeInfoByAccessibilityId(long accessibilityNodeId,
Region interactiveRegion, int interactionId,
IAccessibilityInteractionConnectionCallback callback, int flags,
int interrogatingPid, long interrogatingTid, MagnificationSpec spec, Bundle args) {
ViewRootImpl viewRootImpl = mViewRootImpl.get();
if (viewRootImpl != null && viewRootImpl.mView != null) {
viewRootImpl.getAccessibilityInteractionController()
.findAccessibilityNodeInfoByAccessibilityIdClientThread(accessibilityNodeId,
interactiveRegion, interactionId, callback, flags, interrogatingPid,
interrogatingTid, spec, args);
} else {
// We cannot make the call and notify the caller so it does not wait.
try {
callback.setFindAccessibilityNodeInfosResult(null, interactionId);
} catch (RemoteException re) {
/* best effort - ignore */
}
}
}
...
}
所以,最终AMS会调用到了应用端,同时传递了回调callback用于接收结果:
java
viewRootImpl.getAccessibilityInteractionController()
.findAccessibilityNodeInfoByAccessibilityIdClientThread(
accessibilityNodeId,
interactiveRegion,
interactionId,
callback,
flags,
interrogatingPid,
interrogatingTid,
spec,
args
);
//frameworks/base/core/java/android/view/AccessibilityInteractionController.java


我们之前在AccessibilityService中调用getRootInActiveWindow 使用的 accessibilityId 是 AccessibilityNodeInfo.ROOT_NODE_ID ,这里得到的就是 mViewRootImpl.mView ,即窗口的根视图 DecorView 。
如果此时root view已经可见,则封装并返回root的无障碍节点信息:
java
//frameworks/base/core/java/android/view/AccessibilityInteractionController$AccessibilityNodePrefetcher
public void prefetchAccessibilityNodeInfos(View view, int virtualViewId, int fetchFlags,
List<AccessibilityNodeInfo> outInfos, Bundle arguments) {
...
AccessibilityNodeInfo root = view.createAccessibilityNodeInfo();
if (root != null) {
...
outInfos.add(root);
...
}
...
}
之后将找到的节点通过回调callback.setFindAccessibilityNodeInfosResult(infos, interactionId)传回给请求方。
AMS端传递的callback对应的是AccessibilityService端的AccessibilityInteractionClient 这个 Binder , 结果也就传到了 AccessibilityInteractionClient ,即 IPC 调用过程如下:
< 发起请求 >
AccessibilityService -> IAccessibilityServiceConnection ··· IPC ··· > AccessibilityServiceConnection**-> AMS ->** IAccessibilityInteractionConnection ···IPC···> AccessibilityInteractionConnection -> 当前窗口应用的 ViewRootImpl
**<**返回结果>
当前窗口应用的 ViewRootImpl -> callback ··· IPC ··· > AccessibilityService
返回的是一个列表,我们使用第一个作为找到的root 节点。
findAccessibilityNodeInfosByText
和前面的 IPC 调用过程一样,我们直接去 ViewRootImpl 去找对应的方法:
java
@Override
public void findAccessibilityNodeInfosByText(long accessibilityNodeId, String text,
Region interactiveRegion, int interactionId,
IAccessibilityInteractionConnectionCallback callback, int flags,
int interrogatingPid, long interrogatingTid, MagnificationSpec spec) {
ViewRootImpl viewRootImpl = mViewRootImpl.get();
if (viewRootImpl != null && viewRootImpl.mView != null) {
viewRootImpl.getAccessibilityInteractionController()
.findAccessibilityNodeInfosByTextClientThread(accessibilityNodeId, text,
interactiveRegion, interactionId, callback, flags, interrogatingPid,
interrogatingTid, spec);
} else {
// We cannot make the call and notify the caller so it does not wait.
try {
callback.setFindAccessibilityNodeInfosResult(null, interactionId);
} catch (RemoteException re) {
/* best effort - ignore */
}
}
}
//AccessibilityInteractionController.java
private void findAccessibilityNodeInfosByTextUiThread(Message message) {
...
List<AccessibilityNodeInfo> infos = null;
final View root = findViewByAccessibilityId(accessibilityViewId);
ArrayList<View> foundViews = mTempArrayList;
foundViews.clear();
//首先找出包含检索字符串的view
root.findViewsWithText(foundViews, text, View.FIND_VIEWS_WITH_TEXT
| View.FIND_VIEWS_WITH_CONTENT_DESCRIPTION
| View.FIND_VIEWS_WITH_ACCESSIBILITY_NODE_PROVIDERS);
if (!foundViews.isEmpty()) {
infos = mTempAccessibilityNodeInfoList;
infos.clear();
final int viewCount = foundViews.size();
for (int i = 0; i < viewCount; i++) {
//依次遍历找到的view,满足条件则生成AccessibilityNodeInfo,添加到结果列表中
View foundView = foundViews.get(i);
if (isShown(foundView)) {
provider = foundView.getAccessibilityNodeProvider();
if (provider != null) {
//这里最可能是隐藏不重要节点的地方,通过自定义AccessibilityNodeProvider实现,返回null或者空即可
List<AccessibilityNodeInfo> infosFromProvider = provider.findAccessibilityNodeInfosByText(text,
AccessibilityNodeProvider.HOST_VIEW_ID);
if (infosFromProvider != null) {
infos.addAll(infosFromProvider);
}
} else {
infos.add(foundView.createAccessibilityNodeInfo());
}
}
}
}
...
//通知callback结果
updateInfosForViewportAndReturnFindNodeResult(infos, callback, interactionId, spec, interactiveRegion);
}
主要看root.findViewsWithText
//ViewGroup实现

//View 默认实现

默认情况下,View 类的 getAccessibilityNodeProvider() 返回 null。
//TextView实现
根据代码或者注释,我们知道了匹配规则,系统会遍历View树,只要view可见,定义了content description或text,并且包含我们要查找的文本(忽略大小写),这个view就认为是需要的。所有符合条件的view依次封装为AccessibilityNodeInfo,添加到结果列表infos中:
infos.add(foundView.createAccessibilityNodeInfo());
之后返回结果给callback。
callback.setFindAccessibilityNodeInfosResult(infos, interactionId);
到目前为止并没有看到根据view的importantForAccessibility=no来过滤视图,唯一可能得地方就是foundView自定义了AccessibilityNodeProvider进行了过滤,如源码所示:
java
provider = foundView.getAccessibilityNodeProvider();
if (provider != null) {
List<AccessibilityNodeInfo> infosFromProvider =
provider.findAccessibilityNodeInfosByText(text, AccessibilityNodeProvider.HOST_VIEW_ID);
if (infosFromProvider != null) {
infos.addAll(infosFromProvider);
}
}
只要provider.findAccessibilityNodeInfosByText此时返回null即可。
而遍历节点树的方式只要我们的AccessibilityServie申明了包含不重要视图这个flag, View就能在节点树里找到。
