4.0使用的功能几乎只有一个:检查无障碍服务是否开启
auto() ui模式,检查无障碍服务是否开启
auto.waitFor() 普通模式,检查无障碍服务是否开启
auto.setMode(mode) 开启控件缓存
函数
auto() ui模式下使用 auto.waitFor() 普通模式下使用 auto.setMode(mode) mode 模式 设置无障碍模式为mode。mode的可选值为: normal 正常模式,默认。 fast 快速模式。该模式下会启用控件缓存,从而选择器获取屏幕控件更快。对于需要快速的控件查看和操作的脚本可以使用该模式,一般脚本则没有必要使用该函数。
v4.1.0新增
auto.serivce
获取无障碍服务。如果无障碍服务没有启动,则返回null。
auto.windows
当前所有窗口(AccessibilityWindowInfo)的数组,可能包括状态栏、输入法、当前应用窗口,弹出窗口、悬浮窗、分屏应用窗口等。可以分别获取每个窗口的布局信息。
该函数需要Android 5.0以上才能运行。
auto.root
当前窗口的布局根元素。如果无障碍服务未启动或者WindowFilter均返回false,则会返回null。
如果不设置windowFilter,则当前窗口即为活跃的窗口(获取到焦点、正在触摸的窗口);如果设置了windowFilter,则获取的是过滤的窗口中的第一个窗口。
如果系统是Android5.0以下,则始终返回当前活跃的窗口的布局根元素。
auto.rootInActiveWindow
当前活跃的窗口(获取到焦点、正在触摸的窗口)的布局根元素。如果无障碍服务未启动则为null
auto.setFlags(flags) 启用和禁用某些特性。
flags | 一些标志,来启用和禁用某些特性,包括:
findOnUiThread 使用该特性后,选择器搜索时会在主进程进行。该特性用于解决线程安全问题导致的次生问题,不过目前貌似已知问题并不是线程安全问题。
useUsageStats 使用该特性后,将会以"使用情况统计"服务的结果来检测当前正在运行的应用包名(需要授予"查看使用情况统计"权限)。如果觉得currentPackage()返回的结果不太准确,可以尝试该特性。
useShell 使用该特性后,将使用shell命令获取当前正在运行的应用的包名、活动名称,但是需要root权限。
启用有关automator的一些特性。例如:
auto.setFlags(["findOnUiThread", "useShell"]);
auto.setWindowFilter(filter)
设置窗口过滤器。该函数需要Android 5.0以上才有效。
filter 参数为窗口(AccessibilityWindowInfo),返回值为Boolean的函数。
设置窗口过滤器。这个过滤器可以决定哪些窗口是目标窗口,并影响选择器的搜索。例如,如果想要选择器在所有窗口(包括状态栏、输入法等)中搜索,只需要使用以下代码:
auto.setWindowFilter(function(window){
//不管是如何窗口,都返回true,表示在该窗口中搜索
return true;
});
又例如,当前使用了分屏功能,屏幕上有Auto.js和QQ两个应用,但我们只想选择器对QQ界面进行搜索,则:
auto.setWindowFilter(function(window){
// 对于应用窗口,他的title属性就是应用的名称,因此可以通过title属性来判断一个应用
return window.title == "QQ";
});
选择器默认是在当前活跃的窗口中搜索,不会搜索诸如悬浮窗、状态栏之类的,使用WindowFilter则可以控制搜索的窗口。
需要注意的是, 如果WindowFilter返回的结果均为false,则选择器的搜索结果将为空。
另外setWindowFilter函数也会影响auto.windowRoots的结果。
该函数需要Android 5.0以上才有效。
auto.windowRoots
返回当前被WindowFilter过滤的窗口的布局根元素组成的数组。
如果系统是Android5.0以下,则始终返回当前活跃的窗口的布局根元素的数组。
声明:本站部分资源搜集自网络,相关版权归版权持有人所有,如有侵权,请联络我们,本站会尽快删除。
