Android辅助功能(无障碍)使用---AccessibilityService

矫情吗；* 2022-05-10 13:20 1188阅读 0赞

参考资料：*[https://github.com/PopFisher/AccessibilitySample][https_github.com_PopFisher_AccessibilitySample]*

## 1.Android文档里`AccessibilityService`简介 ##

![在这里插入图片描述][70]

辅助功能只在帮助残障人士使用Android设备和app的时候使用。  
服务进程被杀掉后，下次启动，需再次申请权限

## 2.实现辅助功能服务 ##

实现辅助功能，需要实现`AccessibilityService`类，并重写`onAccessibilityEvent`和`onInterrupt`方法。

代码：

public class AccessibilityTestService extends AccessibilityService { 
    
        @Override
        public void onAccessibilityEvent(AccessibilityEvent event) { 
            String packageName = event.getPackageName().toString();
            int eventType = event.getEventType();
            Log.i("accessibility", "packageName = " + packageName + " eventType = " + eventType);
        }
    
        @Override
        public void onInterrupt() { 
    
        }
    }

开启服务权限后运行，不同页面，打印不同的`packageName`和`eventType`  
结果：

packageName = com.android.mms eventType = 2048
    packageName = com.miui.home eventType = 32
    packageName = com.miui.home eventType = 1
    packageName = com.android.camera eventType = 2048
    packageName = com.android.camera eventType = 32
    packageName = com.android.camera eventType = 2048
    packageName = com.android.camera eventType = 2048
    packageName = com.miui.home eventType = 32
    packageName = com.miui.securitycenter eventType = 64
    packageName = com.android.systemui eventType = 2048

## 3.注册服务 ##

在`AndroidManifest`中注册服务完成配置。  
代码：

`label`标签是在申请权限的设置页面显示该服务的名字。其中需要的`permission`和`<intent-filter>`是必须的，缺少任何一个系统个都会无视这个服务。`<meta-data>`是该服务的一些配置，在`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:accessibilityFlags="flagReportViewIds" android:canRetrieveWindowContent="true" android:description="@string/accessibility_desc" android:notificationTimeout="100" />

其中`accessibilityFlags`是一些额外声明，如果代码重要获取View的ID(通过调用`AccessibilityNodeInfo`的`getViewIdResourceName()`方法)，就必须加上权限`flagReportViewIds`。

## 4.跳转设置页面开启服务 ##

先判断是否开启服务

if (!OpenAccessibilitySettingHelper.isAccessibilitySettingsOn(this,
            AccessibilityTestService.class.getName())) { // 判断服务是否开启
        OpenAccessibilitySettingHelper.jumpToSettingPage(this);// 跳转到开启页面
    } else { 
        ToastUtil.showShortToast(this, "服务已开启");
        //do other things...
    }

`OpenAccessibilitySettingHelper`类：

public class OpenAccessibilitySettingHelper { 
    
        //跳转到设置页面无障碍服务开启自定义辅助功能服务
        public static void jumpToSettingPage(Context context) { 
            Intent intent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS);
            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            context.startActivity(intent);
        }
    
        //判断自定义辅助功能服务是否开启
        public static boolean isAccessibilitySettingsOn(Context context, String className) { 
            if (context == null) { 
                return false;
            }
            ActivityManager activityManager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
            if (activityManager != null) { 
                List<ActivityManager.RunningServiceInfo> runningServices =
                        activityManager.getRunningServices(100);// 获取正在运行的服务列表
                if (runningServices.size() < 0) { 
                    return false;
                }
                for (int i = 0; i < runningServices.size(); i++) { 
                    ComponentName service = runningServices.get(i).service;
                    if (service.getClassName().equals(className)) { 
                        return true;
                    }
                }
                return false;
            } else { 
                return false;
            }
        }
    }

## 5.辅助功能具体实现类 ##

模拟的一些点击，退出，拖动，获取界面信息等具体的实现方法，主要是通过节点查找，找到要操作的控件。  
首先要在实现的`AccessibilityTestService`中重写的`onAccessibilityEvent`方法中和`event`绑定。

AccessibilityOperator.getInstance().updateEvent(this, event);

updateEvent方法

public void updateEvent(AccessibilityService service, AccessibilityEvent event) { 
        if (service != null && mAccessibilityService == null) { 
            mAccessibilityService = service;
        }
        if (event != null) { 
            mAccessibilityEvent = event;
        }
    }

根据text搜索所有符合的节点

public List<AccessibilityNodeInfo> findNodesByText(String text) { 
        AccessibilityNodeInfo nodeInfo = getRootNodeInfo();
        if (nodeInfo != null) { 
            Log.i("accessibility", "getClassName：" + nodeInfo.getClassName());
            Log.i("accessibility", "getText：" + nodeInfo.getText());
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR2) { 
                //需要在xml文件中声明权限android:accessibilityFlags="flagReportViewIds"
                // 并且版本大于4.3 才能获取到view 的 ID
                Log.i("accessibility", "getClassName：" + nodeInfo.getViewIdResourceName());
            }
            return nodeInfo.findAccessibilityNodeInfosByText(text);
        }
        return null;
    }

根据ID搜索所有符合的节点

public List<AccessibilityNodeInfo> findNodesById(String viewId) { 
        AccessibilityNodeInfo nodeInfo = getRootNodeInfo();
        if (nodeInfo != null) { 
            if (Build.VERSION.SDK_INT >= 18) { 
                return nodeInfo.findAccessibilityNodeInfosByViewId(viewId);
            }
        }
        return null;
    }

获取跟节点

private AccessibilityNodeInfo getRootNodeInfo() { 
        AccessibilityEvent curEvent = mAccessibilityEvent;
        AccessibilityNodeInfo nodeInfo = null;
        if (Build.VERSION.SDK_INT >= 16) { 
            if (mAccessibilityService != null) { 
                nodeInfo = mAccessibilityService.getRootInActiveWindow();
            }
        } else { 
            nodeInfo = curEvent.getSource();
        }
        return nodeInfo;
    }

模拟点击

private boolean performClick(List<AccessibilityNodeInfo> nodeInfos) { 
        if (nodeInfos != null && !nodeInfos.isEmpty()) { 
            AccessibilityNodeInfo node;
            for (int i = 0; i < nodeInfos.size(); i++) { 
                node = nodeInfos.get(i);
                // 获得点击View的类型
                Log.i("accessibility", "getClassName：" + node.getClassName());
                // 进行模拟点击
                if (node.isEnabled()) { 
                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) { 
                        return node.performAction(AccessibilityNodeInfo.ACTION_CLICK);
                    }
                }
            }
        }
        return false;
    }

模拟退出键

@RequiresApi(api = Build.VERSION_CODES.JELLY_BEAN)
    public boolean clickBackKey() { 
        return mAccessibilityService.performGlobalAction(AccessibilityService.GLOBAL_ACTION_BACK);
    }

需要调用的地方直接获取`AccessibilityOperator`实例，获取到需要操作的节点后调用模拟方法。

## 6.通过Android Device Monitor来直接获取界面中View的ID ##

如图所示，打开`Android Device Monitor`  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI4MzU2ODMz_size_16_color_FFFFFF_t_70]  
可能会有报错信息，因为AndroidStudio自动默认选的是64位的环境，如果出错的话，可直接在该运行程序的目录手动开启  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI4MzU2ODMz_size_16_color_FFFFFF_t_70 1]  
默认打开的是64位的，可手动打开第一个。  
然后选中连接的模拟器，点击方框的按钮后，可以将手机当前页面的布局框架加载进来。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI4MzU2ODMz_size_16_color_FFFFFF_t_70 2]

点击布局上需要获取`resourceid`的view 后，会出现该view的id，但是有些view没有id，代码里获取的也是null，例如`GooglePlay`里某个应用的安装按钮就没有`resourceid`。但是他的父布局是有`resourceid`的，可以利用获取父布局的节点，再获取该父布局的某个子节点。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI4MzU2ODMz_size_16_color_FFFFFF_t_70 3]

获取某个节点的某个子节点代码：

private AccessibilityNodeInfo getChildNodeInfos(String id, int childIndex) { 
        List<AccessibilityNodeInfo> listChatRecord = findNodesById(id);
        if (listChatRecord == null || listChatRecord.size() == 0) { 
            return null;
        }
        AccessibilityNodeInfo parentNode = listChatRecord.get(0);//该节点
        int count = parentNode.getChildCount();
        Log.i("accessibility", "子节点个数 " + count);
        return childIndex < count ? parentNode.getChild(childIndex) : null;
    }

[https_github.com_PopFisher_AccessibilitySample]: https://github.com/PopFisher/AccessibilitySample
[70]: /images/20220505/45b4d3ed48ce47faa54705a7a2971d52.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI4MzU2ODMz_size_16_color_FFFFFF_t_70]: /images/20220505/685085e3cee548b5a718853897e7a66f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI4MzU2ODMz_size_16_color_FFFFFF_t_70 1]: /images/20220505/6cea443e4e3e45048c33e3e60cf2abd6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI4MzU2ODMz_size_16_color_FFFFFF_t_70 2]: /images/20220505/65503bd3dd49486cab7ed3b55f98152c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI4MzU2ODMz_size_16_color_FFFFFF_t_70 3]: /images/20220505/c89cfc43393140688e4012bbf8665389.png