Android之辅助服务上篇————AccessibilityService使用

文章目录

Android之辅助服务上篇————AccessibilityService使用

一.前言
二.概述

1.辅助服务是什么
2.辅助服务生命周期

三.配置

1.继承AccessbilityService类
2.在AndroidManifest中注册该服务
3.配置AccessbilityService

四.使用

1.启动服务
2.获取事件信息
3.处理事件--寻找控件
4.处理事件--操作控件

五.综合应用

1.获得View对应的id
2.AccessibilityService的手势控制
3.AccessibilityService的基础类
4.实际应用

六.参考资料

一.前言

最近好久没写博客了，特别是Android系统启动这一个系列，虽然过程已经理了很多遍了，但是由于实习期间是在抽不出时间，没办法输出文章。最近接触了Android辅助服务，即AccessibilityService的相关内容，也算是解决了我一直一来的困惑——微信抢红包插件是怎么实现的。这两天，抽空总结一下这一部分相关的内容，上篇介绍使用，下篇分析原理。

二.概述

1.辅助服务是什么

下面两个链接是Google官方对于辅助服务的介绍：
辅助服务使用官方介绍
辅助服务类官方api文档

辅助服务的设计初衷提供给无法和界面进行交互的残疾用户。来协助帮助他们进行一些用户操作，比如点击，返回，长按，获取屏幕信息等能力。后来被开发者另辟蹊径，用于一些插件开发，做一些监听第三方应用的插件。

下面是辅助服务的继承关系：

2.辅助服务生命周期

辅助服务的生命周期由系统专门管理，并遵循Server的生命周期。服务的启动只能用户在设备设置中明确启动服务来触发。当系统绑定到服务后，它会调用AccessibilityService#onServiceConnected()方法。当用户在设置设置中关闭时，辅助服务功能将停止，或者调用AccessibilityService#disableSelf()方法。giant服务会被关闭销毁

设备设置无障碍选择：

下面是关于AccessibilityService的使用

三.配置

1.继承AccessbilityService类

要使用辅助服务，首先先继承AccessbilityService类，并且重写其方法。

public class StatusAccessibilityService extends AccessibilityService {    /**     * 发生用户界面事件回调此事件     * @param event     */    @Override    public void onAccessibilityEvent(AccessibilityEvent event) {    }    /**     * 中断可访问性反馈     */    @Override    public void onInterrupt() {    }}

除了上面的两个必须要重写的方法外，AccessbilityService还提供了下面的一些方法：

disableSelf()，禁用当前服务，也就是说关闭当服务
dispatchGesture(GestureDescription gesture, AccessibilityService.GestureResultCallback callback, Handler handler)，将手势发送到触摸屏
findFocus(int focus)：寻找到具有指定焦点类型的视图。
getRootInActiveWindow()：获取当前活动窗口中的根节点。
getServiceInfo()：获取当前服务的配置信息
getSystemService(String name)：获取系统服务
getWindows():获取屏幕上的窗口。
performGlobalAction(int action)：执行全局操作：比如返回，回到主页，打开最近等操作
setServiceInfo(AccessibilityServiceInfo info):设置当前服务的配置信息 (下面的配置AccessbilityService会介绍)

不太常用的：

getAccessibilityButtonController()：返回系统导航区域内辅助功能按钮的控制器。
getFingerprintGestureController()：获取指纹手势的控制器。
getMagnificationController():返回放大器控制器，可用于查询和修改显示放大率的状态。
getSoftKeyboardController():返回软键盘控制器，可用于查询和修改软键盘显示模式。

2.在AndroidManifest中注册该服务

AccessbilityService是一个服务，所以同样，他也要在AndroidManifest中注册：

        <service            android:name="com.hahak.walle.accessibilitydame.StatusAccessibilityService"            android:label="辅助服务测试"            android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">            <intent-filter>                <action android:name="android.accessibilityservice.AccessibilityService"/>            </intent-filter>        </service>

android:permission：需要指定BIND_ACCESSIBILITY_SERVICE权限，这是4.0以上的系统要求的
intent-filter：这个name是固定不变的

3.配置AccessbilityService

接下来，就是配置服务参数，即设定AccessbilityService所能干的事。
配置方法有两种，一种是在代码中动态设置，一种是写配置文件。

方法1.写配置文件
首先在AndroidManifest中生命配置文件的位置

       <service            android:name="com.hahack.walle.AutoCheckStatusAccessibilityService"            android:label="运营助手：自动艾特用户"            android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">            <intent-filter>                <action android:name="android.accessibilityservice.AccessibilityService"/>            intent-filter>            <meta-data                android:name="android.accessibilityservice"                android:resource="@xml/allocation"/>        service>

其次，在@xml/allocation文件中，声明下面的内容

<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"    android:accessibilityEventTypes="typeAllMask"    android:description="demo"    android:accessibilityFeedbackType="feedbackSpoken"    android:canRetrieveWindowContent="true"    android:notificationTimeout="1000"/>

方法2:.在代码中动态添加
在自定义的AccessibilityService类中，可以通过在AccessibilityServiceInfo类重写onServiceConnected()，并通过 this.setServiceInfo来添加配置

@Overridepublic void onServiceConnected() {    info.eventTypes = AccessibilityEvent.TYPE_VIEW_CLICKED |            AccessibilityEvent.TYPE_VIEW_FOCUSED;    info.packageNames = new String[]            {"com.example.android.myFirstApp", "com.example.android.mySecondApp"};    info.feedbackType = AccessibilityServiceInfo.FEEDBACK_SPOKEN    info.notificationTimeout = 100;    this.setServiceInfo(info);}

下面说说配置内容的具体含义：

accessibilityEventTypes：此服务希望按照指定接收的事件类型(AccessibilityEvent)

常量	描述
typeViewClicked	点击事件
typeViewSelected	view被选择
typeViewScrolled	滑动事件
typeWindowContentChanged	窗口内容该表
typeAllMask	所有事件

accessibilityFeedbackType：此服务提供的反馈类型，比如说是语音播报还是真的震动

常量	描述
feedbackSpoken	语音反馈
feedbackHaptic	触觉（震动）反馈
feedbackAudible	音频反馈
feedbackVisual	视频反馈
feedbackGeneric	通用反馈
feedbackAllMask	以上都具有

canRetrieveWindowContent：表示该服务能否访问活动窗口中的内容。也就是如果你希望在服务中获取窗体内容，则需要设置其值为true
description：对该无障碍功能的描述。
notificationTimeout：接受事件的时间间隔，通常将其设置为100即可
packageNames：表示对该服务是用来监听哪个包的产生的事件，上面以微信的包名为例
canPerformGestures:表示是否允许进行手势分发
canRequestFilterKeyEvents：辅助服务希望能够请求过滤关键事件。
nonInteractiveUiTimeout：超时设置，未不包含交互式空间返回合适的值

四.使用

1.启动服务

辅助服务的启动必须通过用户设置来开启，所以我们要先提醒用户进行无障碍功能列表

Intent intent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS);startActivity(intent);

通过上面的代码就可以打开系统的无障碍功能列表

2.获取事件信息

当我们监听的目标应用界面或者界面等信息，会通过onAccessibilityEvent回调我们的事件，接着进行事件的处理。

@Override    public void onAccessibilityEvent(final AccessibilityEvent event) {        String packageName = event.getPackageName().toString();        if (!packageName.equals("com.tencent.mm")) {            return;        }        int eventType = event.getEventType();        switch (eventType) {            case AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED:            处理            ....        }

可以看出，当发生变化时，回调onAccessibilityEvent方法，并传入AccessibilityEvent类型。下面让我们看看AccessibilityEvent的含义。

先看看AccessibilityEvent提供的方法(源是指触发此方法的ui/时间)：

getAction()：获取触发此世界的已执行操作
getEventTime()：获取发送此事件的时间
getEventType()：获取事件类型。
getPackageName()：获取源的包名称
从AccessibilityRecord基础的方法
getMaxScrollY()：获取源上边缘的最大滚动偏移（以像素为单位）
getMaxScrollX()：获取源左边缘的最大滚动偏移量（以像素为单位）。
getClassName()：获取源的类名。
getText()：获取事件的文本，比如事件是有TextView发出的,此时获取的就是TextView的text属性。如果该事件源是树结构，那么此时获取的是这个树上所有具有text属性的值的集合
getToIndex()：获取滚动时文本选择结束的索引或最后一个可见项的索引。
getItemCount()：如果事件源是树结构，将返回该树根节点下子节点的数量
更详细的可以参考官方文档：
AccessibilityEvent官方api介绍

关于事件类型getEventType()返回值：

TYPE_VIEW_LONG_CLICKED 长按事件
TYPE_VIEW_CONTEXT_CLICKED点击事件
TYPE_WINDOW_STATE_CHANGED 表示用户界面被更改。
TYPE_NOTIFICATION_STATE_CHANGED：通知栏的改变
TYPE_WINDOWS_CHANGED：表示系统窗口的时间变更
…还有很多，详情可以看看官方文档

3.处理事件–寻找控件

当我们接受到事件后，根据事件就可以处理对应的时间，比如说检测到弹窗，就可以转换为动作：点击弹窗。
处理事件总的来说，分为两个步骤。第一步，寻找该控件。第二部，模拟人的操作对各个控件进行操作(点击，长按，输入，读取)

寻找控件
寻找控件首先要找的它对象窗口内容对应的树，即AccessibilityWindowInfo(代表)和AccessibilityNodeInfo(代表具体的View)。注意，这个功能需要在xml资源配置中声明SERVICE_META_DATA。
针对寻找AccessibilityWindowInfo和AccessibilityNodeInfo，谷歌官方提供了下面的api

AccessibilityEvent#getSource(),返回值为发起当前事件的控件的AccessibilityNodeInfo
AccessibilityService#findFocus(int)，参数表示输入焦点，返回值为指定焦点对应的AccessibilityNodeInfo
AccessibilityService#getWindows()，返回值为当前所有可交互窗户的 AccessibilityWindowInfo列表（List）
AccessibilityService#getRootInActiveWindow()，返回值为当前活动的AccessibilityWindowInfo，如果用户没有触摸任何窗口，则活动窗口是具有输入焦点的窗口。

AccessibilityWindowInfo：
AccessibilityWindowInfo表示可访问窗口的状态快照。屏幕内容包含一个或者多个窗口，其中一些窗口可以是其他窗口的后代，窗口是次序排序的。
AccessibilityWindowInfor提供的api简介：

getChild(int index) ，返回给定索引处的子窗口的AccessibilityWindowInfo
getChildCount()，返回代表子窗口的数量的int值
getId(),返回代表唯一的窗口id的int值
getParent()，返回代表父窗口的AccessibilityWindowInfo
getLayer()，返回代表窗口在z轴的图层的int值
getRoot()，返回代表窗口层次中根节点的AccessibilityNodeInfo
…其余详见官网文档

AccessibilityNodeInfo：
AccessibilityNodeInfo表示窗口内容的节点以及可以进行的操作。
AccessibilityNodeInfo内部类介绍：

AccessibilityAction，表示可以对AccessibilityNodeInfo提供的操作
CollectionInfo，表示当节点是集合时，包含集合信息的类。
CollectionItemInfo，表示当节点是集合子项，包含集合子项信息的类。
RangeInfo，表示当节点是范围，包含该范围包含信息的类。

AccessibilityNodeInfo提供的api简述

addAction(action: AccessibilityNodeInfo.AccessibilityAction)/(action: Int)，添加可在节点上执行的操作,有两个同名方法，参数不同
performAction(action: Int)，在节点上执行操作
addChild(child: View!)添加一个子项
findAccessibilityNodeInfosByText(text: String!)，按文字寻找对应的控件，并返回其 AccessibilityNodeInfo
findAccessibilityNodeInfosByViewId(viewId: String!)，根据View的id资源名称查找对应的View，返回AccessibilityNodeInfo
findFocus(focus: Int)，找到具有指定焦点类型的视图。返回AccessibilityNodeInfo
focusSearch(direction: Int)，搜索指定方向上可以获取输入焦点的最近视图。返回AccessibilityNodeInfo
getActionList()，获取可以在节点上执行的操作。
getHintText()，获取此节点的提示文本
getText()，获取此节点的文本
isClickable()，获取此节点是否可单击，还有其他对于的方法，判断节点是否可操作
…其余详见官网文档

4.处理事件–操作控件

在上面一小节里，我们通过addAction，可以给AccessibilityNodeInfo添加对于的动作，其参数是 AccessibilityNodeInfo的内部类AccessibilityAction。

AccessibilityAction
AccessibilityAction表示可以对AccessibilityNodeInfo。每个操作都有一个唯一的ID，这是必需的和可选的数据。
其有三类动作

标准操作 - 这些操作由平台中的标准UI小部件报告和处理。对于每个标准动作，在该类中定义了一个静态常量，例如ACTION_FOCUS。这些操作将有null标签。
自定义操作操作 - 这些是由自定义窗口小部件报告和处理的操作。即不属于UI工具包的那些。例如，应用程序可以定义用于清除用户历史的自定义操作。
覆盖标准操作 - 这些操作会覆盖标准操作以自定义它们。例如，应用可以向标准ACTION_CLICK操作添加标签，以向用户指示此操作清除浏览历史记录。

可提供的操作

ACTION_ACCESSIBILITY_FOCUS，为可访问性提供焦点的操作。
ACTION_CLEAR_ACCESSIBILITY_FOCUS，清除节点可访问性焦点的操作。
ACTION_CLICK，单击节点信息的操作。
ACTION_LONG_CLICK,长按
ACTION_FOCUS，为输入焦点提供节点
ACTION_COPY，将当前选择复制到剪贴板的操作。
ACTION_CUT，剪切
ACTION_PAGE_DOWN，移动到下一页，以及移动到下，左，右页面
ACTION_PASTE，粘贴剪切板内容
ACTION_SCROLL_BACKWARD/ACTION_SCROLL_FORWARD ,下滑/上滑
ACTION_SET_TEXT，设置节点文本
…其余详见官网文档

五.综合应用

1.获得View对应的id

打开tools–>Android–>Android Device Monitor
选择设备，并点击图中坐标
选择对应的控件进行点击查看

2.AccessibilityService的手势控制

在Android7.0之后，AccessibilityService又增加了一个新的方法dispatchGesture。可以将手势发送到触摸屏上。但是要使用这个功能必须在配置文件中声明，canPerformGestures = “true”

api接口:

public final boolean dispatchGesture (GestureDescription gesture,                 AccessibilityService.GestureResultCallback callback,                 Handler handler)

参数:

GestureDescription：要分派的手势
AccessibilityService.GestureResultCallback:完成后的回调
Handler；处理回调程序的线程，如果传入null,则为主线程

使用示例

        Path path = new Path();        path.moveTo(0, 400);        path.lineTo(400, 400);        final GestureDescription.StrokeDescription sd;        sd = new GestureDescription.StrokeDescription(path, 100, 50);        //先横滑        boolean flag = this.dispatchGesture(new GestureDescription.Builder().addStroke(sd).build(), new AccessibilityService.GestureResultCallback() {            @Override            public void onCompleted(GestureDescription gestureDescription) {                super.onCompleted(gestureDescription);                Log.d("22222", "onCompleted:横滑 ");                Path path2 = new Path();                path2.moveTo(600, 600);                path2.lineTo(600, 800);                final GestureDescription.StrokeDescription sd2 = new GestureDescription.StrokeDescription(path2, 1000, 500);                //滑完后再过1秒竖滑                BaseAccessibilityService.this.dispatchGesture(new GestureDescription.Builder().addStroke(sd2)/*.addStroke(sd2)*/.build(), null, null);            }            @Override            public void onCancelled(GestureDescription gestureDescription) {                Log.d("22222", "onCancelled");                super.onCancelled(gestureDescription);            }        }, null);

上图的示例为左滑和下滑，如果要实现点击事件，则可以只传入一个点Path。即

Path path = new Path();path.moveTo(0, 400);sd = new GestureDescription.StrokeDescription(path, 100, 50);

3.AccessibilityService的基础类

下面是对AccessibilityService提供的各种方法的封装

public class BaseAccessibilityService extends AccessibilityService {    private AccessibilityManager mAccessibilityManager;    private Context mContext;    private static BaseAccessibilityService mInstance;    public void init(Context context) {        mContext = context.getApplicationContext();        mAccessibilityManager = (AccessibilityManager) mContext.getSystemService(Context.ACCESSIBILITY_SERVICE);    }    public static BaseAccessibilityService getInstance() {        if (mInstance == null) {            mInstance = new BaseAccessibilityService();        }        return mInstance;    }    /**     * Check当前辅助服务是否启用     *     * @param serviceName serviceName     * @return 是否启用     */    private boolean checkAccessibilityEnabled(String serviceName) {        List<AccessibilityServiceInfo> accessibilityServices =                mAccessibilityManager.getEnabledAccessibilityServiceList(AccessibilityServiceInfo.FEEDBACK_GENERIC);        for (AccessibilityServiceInfo info : accessibilityServices) {            if (info.getId().equals(serviceName)) {                return true;            }        }        return false;    }    /**     * 前往开启辅助服务界面     */    public void goAccess() {        Intent intent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS);        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);        mContext.startActivity(intent);    }    /**     * 模拟点击事件     *     * @param nodeInfo nodeInfo     */    public void performViewClick(AccessibilityNodeInfo nodeInfo) {        if (nodeInfo == null) {            return;        }        while (nodeInfo != null) {            if (nodeInfo.isClickable()) {                nodeInfo.performAction(AccessibilityNodeInfo.ACTION_CLICK);                break;            }            nodeInfo = nodeInfo.getParent();        }    }    /**     * 模拟返回操作     */    public void performBackClick() {        try {            Thread.sleep(500);        } catch (InterruptedException e) {            e.printStackTrace();        }        performGlobalAction(GLOBAL_ACTION_BACK);    }    /**     * 模拟下滑操作     */    public void performScrollBackward() {        try {            Thread.sleep(500);        } catch (InterruptedException e) {            e.printStackTrace();        }        performGlobalAction(AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD);    }    /**     * 模拟上滑操作     */    @RequiresApi(api = Build.VERSION_CODES.N)    public void performScrollForward() {        try {            Thread.sleep(500);        } catch (InterruptedException e) {            e.printStackTrace();        }        performGlobalAction(AccessibilityNodeInfo.ACTION_SCROLL_FORWARD);    }    /**     * 查找对应文本的View     *     * @param text text     * @return View     */    public AccessibilityNodeInfo findViewByText(String text) {        return findViewByText(text, false);    }    /**     * 查找对应文本的View     *     * @param text      text     * @param clickable 该View是否可以点击     * @return View     */    public AccessibilityNodeInfo findViewByText(String text, boolean clickable) {        AccessibilityNodeInfo accessibilityNodeInfo = getRootInActiveWindow();        if (accessibilityNodeInfo == null) {            return null;        }        List<AccessibilityNodeInfo> nodeInfoList = accessibilityNodeInfo.findAccessibilityNodeInfosByText(text);        if (nodeInfoList != null && !nodeInfoList.isEmpty()) {            for (AccessibilityNodeInfo nodeInfo : nodeInfoList) {                if (nodeInfo != null && (nodeInfo.isClickable() == clickable)) {                    return nodeInfo;                }            }        }        return null;    }    /**     * 查找对应ID的View     *     * @param id id     * @return View     */    @TargetApi(Build.VERSION_CODES.JELLY_BEAN_MR2)    public AccessibilityNodeInfo findViewByID(String id) {        AccessibilityNodeInfo accessibilityNodeInfo = getRootInActiveWindow();        if (accessibilityNodeInfo == null) {            return null;        }        List<AccessibilityNodeInfo> nodeInfoList = accessibilityNodeInfo.findAccessibilityNodeInfosByViewId(id);        if (nodeInfoList != null && !nodeInfoList.isEmpty()) {            Log.d("dd", "findViewByID: " + nodeInfoList.size());            for (AccessibilityNodeInfo nodeInfo : nodeInfoList) {                Log.d("dd", "findViewByID: " + nodeInfo.toString());                if (nodeInfo != null) {                    return nodeInfo;                }            }        }        return null;    }    public void clickTextViewByText(String text) {        AccessibilityNodeInfo accessibilityNodeInfo = getRootInActiveWindow();        if (accessibilityNodeInfo == null) {            return;        }        List<AccessibilityNodeInfo> nodeInfoList = accessibilityNodeInfo.findAccessibilityNodeInfosByText(text);        if (nodeInfoList != null && !nodeInfoList.isEmpty()) {            for (AccessibilityNodeInfo nodeInfo : nodeInfoList) {                if (nodeInfo != null) {                    performViewClick(nodeInfo);                    break;                }            }        }    }    @TargetApi(Build.VERSION_CODES.JELLY_BEAN_MR2)    public void clickTextViewByID(String id) {        AccessibilityNodeInfo accessibilityNodeInfo = getRootInActiveWindow();        if (accessibilityNodeInfo == null) {            return;        }        List<AccessibilityNodeInfo> nodeInfoList = accessibilityNodeInfo.findAccessibilityNodeInfosByViewId(id);        if (nodeInfoList != null && !nodeInfoList.isEmpty()) {            for (AccessibilityNodeInfo nodeInfo : nodeInfoList) {                if (nodeInfo != null) {                    performViewClick(nodeInfo);                    break;                }            }        }    }    /**     * 模拟输入     *     * @param nodeInfo nodeInfo     * @param text     text     */    public void inputText(AccessibilityNodeInfo nodeInfo, String text) {        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {            Bundle arguments = new Bundle();            arguments.putCharSequence(AccessibilityNodeInfo.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE, text);            nodeInfo.performAction(AccessibilityNodeInfo.ACTION_SET_TEXT, arguments);        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR2) {            ClipboardManager clipboard = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);            ClipData clip = ClipData.newPlainText("label", text);            clipboard.setPrimaryClip(clip);            nodeInfo.performAction(AccessibilityNodeInfo.ACTION_FOCUS);            nodeInfo.performAction(AccessibilityNodeInfo.ACTION_PASTE);        }    }    @Override    public void onAccessibilityEvent(AccessibilityEvent event) {        Log.d("dd", "onAccessibilityEvent: " + event.toString());    }    @Override    public void onInterrupt() {    }    @Override    protected void onServiceConnected() {        super.onServiceConnected();        Log.d("llll", "onServiceConnected: ");    }}

4.实际应用

学习了大部分的AccessibilityService相关知识。就可以灵活运用这些内容进行组装。
比如说：

微信红包外挂
支付宝自动收能量
微信自动发消息
朋友圈自动点赞
…

六.参考资料

官方api文档
官网辅助服务介绍
妙用AccessibilityService黑科技实现微信自动加好友拉人进群聊

Android之辅助服务上篇————AccessibilityService使用

Android之辅助服务上篇————AccessibilityService使用

文章目录

一.前言

二.概述

1.辅助服务是什么

2.辅助服务生命周期

三.配置

1.继承AccessbilityService类

2.在AndroidManifest中注册该服务

3.配置AccessbilityService

四.使用

1.启动服务

2.获取事件信息

3.处理事件–寻找控件

4.处理事件–操作控件

五.综合应用

1.获得View对应的id

2.AccessibilityService的手势控制

3.AccessibilityService的基础类

4.实际应用

六.参考资料

更多相关文章

随机推荐