$act 返回
手势动作
hasPermit()
版本:1.0.0
无障碍服务是否开启
- 返回 : {boolean} 是否开启
//判断是否有权限
let hasPermit = $act.hasPermit();
$tip.show("是否获得无障碍", hasPermit);
getPermit()
版本:1.0.0
获得无障碍服务
- 返回 : {boolean} 是否获得
//会循环获得无障碍权限,意味着会阻塞其他$act函数,哪怕是在不同的脚本文件和其他线程中
//如果没有获得无障碍,每间隔30秒会重新请求一次
$act.getPermit();//获得权限
click(x,y)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x {int} 点击位置x
- 参数 : y {int} 点击位置y
//点击手势
$act.click(500, 800);
click(x,y,dur)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x {int} 点击位置x
- 参数 : y {int} 点击位置y
- 参数 : dur {int} 点击后延迟
//设置点击时常(长按效果)
sleep(1000);
$act.click(135, 344, 1500);
click(x,y,dur,delay)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x {int} 点击位置x
- 参数 : y {int} 点击位置y
- 参数 : dur {int} 点击后延迟
- 参数 : delay {int} 点击前延迟
//点击手势(长按)(延迟一秒)
$act.click(500, 800, 1500, 100);
click(index)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : index {int[]} 点击位置
//点击
$act.click([500, 800]);
click(index,dur)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : index {int[]} 点击位置
- 参数 : dur {int} 点击后延迟
//点击手势(长按)
$act.click([135, 347], 1500);
click(index,dur,delay)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : index {int[]} 点击位置
- 参数 : dur {int} 点击后延迟
- 参数 : delay {int} 点击前延迟
//点击手势(长按)(延迟一秒)
$act.click([136, 347], 1500, 100);
click(index)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : index {Point} 点击位置
//点击手势(点击opencv返参)
let point = new org.opencv.core.Point(136, 347);
$act.click(point);
click(index,dur)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : index {Point} 点击位置
- 参数 : dur {int} 点击后延迟
//点击手势(长按)(延迟一秒)
let point = new org.opencv.core.Point(136, 347);
$act.click(point, 1500);
click(index,dur,delay)
版本:1.0.0
点击
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : index {Point} 点击位置
- 参数 : dur {int} 点击后延迟
- 参数 : delay {int} 点击前延迟
//点击手势(长按)(延迟一秒)
let point = new org.opencv.core.Point(136, 347);
$act.click(point, 1500, 100);
click(node)
版本:1.0.0
点击节点
当传入的节点不可点击时使用手势点击,如果手机root则优先使用root手势点击
- 参数 : node {AccessibilityNodeInfo} 点击位置
click(node,useAct)
版本:1.0.0
点击节点
当传入的节点不可点击时使用手势点击,如果手机root则优先使用root手势点击
- 参数 : node {AccessibilityNodeInfo} 点击位置
- 参数 : useAct {boolean} 是否使用无障碍点击
press(node)
版本:1.0.0
长按节点
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : node {AccessibilityNodeInfo} 节点
press(x,y)
版本:1.0.0
长按
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x {int} 长按位置x
- 参数 : y {int} 长按位置y
//点击手势(长按)(延迟一秒)
$act.press(136, 347);
press(x,y,dur)
版本:1.0.0
长按
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x {int} 长按位置x
- 参数 : y {int} 长按位置y
- 参数 : dur {int} 长按后延迟
//点击手势(长按)(延迟一秒)
$act.press(136, 347, 1500);
press(x,y,dur,delay)
版本:1.0.0
长按
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x {int} 长按位置x
- 参数 : y {int} 长按位置y
- 参数 : dur {int} 长按后延迟
- 参数 : delay {int} 长按前延迟
//点击手势(长按)(延迟一秒)
$act.press(136, 347, 1500, 100);
move(x1,y1,x2,y2)
版本:1.0.0
滑动
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x1 {int} 起点x
- 参数 : y1 {int} 起点y
- 参数 : x2 {int} 终点x
- 参数 : y2 {int} 终点y
//滑动手势
$act.move(500, 0, 500, 800);
move(x1,y1,x2,y2,dur)
版本:1.0.0
滑动
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x1 {int} 起点x
- 参数 : y1 {int} 起点y
- 参数 : x2 {int} 终点x
- 参数 : y2 {int} 终点y
- 参数 : dur {int} 滑动延迟
//滑动手势
$act.move(500, 0, 500, 800, 500);
move(x1,y1,x2,y2,dur,delay)
版本:1.0.0
滑动
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : x1 {int} 起点x
- 参数 : y1 {int} 起点y
- 参数 : x2 {int} 终点x
- 参数 : y2 {int} 终点y
- 参数 : dur {int} 滑动时间
- 参数 : delay {int} 滑动延迟
//滑动手势
$act.move(500, 0, 500, 800, 500.1000);
move(node,dir)
版本:1.0.0
滑动节点
仅无障碍可用
- 参数 : node {AccessibilityNodeInfo} 节点
- 参数 : dir {String} 方向(up|down|left|right)
move(node,x2,y2,dur)
版本:1.0.0
滑动
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : node {AccessibilityNodeInfo} 节点
- 参数 : x2 {int} 终点x
- 参数 : y2 {int} 终点y
- 参数 : dur {int} 滑动时间
//滑动手势
$act.move(node, 800, 500, 1000);
move(node,x2,y2,dur,delay)
版本:1.0.0
滑动
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : node {AccessibilityNodeInfo} 节点
- 参数 : x2 {int} 终点x
- 参数 : y2 {int} 终点y
- 参数 : dur {int} 滑动时间
- 参数 : delay {int} 滑动延迟
//滑动手势
$act.move(node, 800, 500, 1000, 100);
gesture(gesture)
版本:1.0.0
多指手势
- 参数 : gesture {int[]} 动作数据数组[起点x,起点y,终点x,终点y,开始时间,时长]
// 手势模拟向下滑动
$act.gesture([500, 0, 500, 800, 0, 500]);
gesture(gesture1,gesture2)
版本:1.0.0
双指手势
如果设备获得了root,将优先使用root来执行手势,如果没有root,则使用无障碍来执行手势
- 参数 : gesture1 {int[]} 动作数据数组[起点x,起点y,终点x,终点y,开始时间,时长]
- 参数 : gesture2 {int[]} 动作数据数组[起点x,起点y,终点x,终点y,开始时间,时长]
// 双指放大
let centerX = 500;
let centerY = 800;
$act.gesture(
[centerX, centerY, centerX - 400, centerY - 400, 0, 500],
[centerX, centerY, centerX + 400, centerY + 400, 0, 500]
);
gesture(gesture1,gesture2,gesture3)
版本:1.0.0
三指动作
注意:root无法执行多指手势,只能使用无障碍
- 参数 : gesture1 {int[]} 动作数据数组
- 参数 : gesture2 {int[]} 动作数据数组
- 参数 : gesture3 {int[]} 动作数据数组
//三指滑动动作
$act.gesture([500, 0, 500, 800, 500, 0],
[550, 0, 550, 800, 500, 0],
[600, 0, 600, 800, 500, 0]
);
gesture(gesture1,gesture2,gesture3,gesture4)
版本:1.0.0
四指动作
注意:root无法执行多指手势,只能使用无障碍
- 参数 : gesture1 {int[]} 动作数据数组
- 参数 : gesture2 {int[]} 动作数据数组
- 参数 : gesture3 {int[]} 动作数据数组
//四指滑动动作
$act.gesture([500, 0, 500, 800, 500, 0],
[550, 0, 550, 800, 500, 0],
[600, 0, 600, 800, 500, 0],
[650, 0, 650, 800, 500, 0]
);
createPath(paths)
版本:1.0.0
通过路径来构建path对象(默认持续时间为1秒)
- 参数 : paths {[][]} 动作数据数组
- 返回 : {Path}
createPath(paths,dur)
版本:1.0.0
通过路径来构建path对象
- 参数 : paths {[][]} 动作数据数组
- 参数 : dur {int} 持续
- 返回 : {AgPath} 路径对象
createPath(paths,delay,dur)
版本:1.0.0
通过路径来构建path对象
- 参数 : paths {[][]} 动作数据数组
- 参数 : delay {int} 开始时间
- 参数 : dur {int} 延迟
- 返回 : {Path}
path(paths)
版本:1.0.0
执行路径
- 参数 : paths {AgPath...} 多路径
path(paths)
版本:1.0.0
构建一个路径并且执行(默认时间为1秒)
- 参数 : paths {int[][]} 动作数据数组
path(paths,dur)
版本:1.0.0
构建一个路径并且执行
- 参数 : paths {int[][]} 动作数据数组
path(paths,startTime,dur)
版本:1.0.0
构建一个路径并且执行
- 参数 : paths {int[][]} 动作数据数组
home()
版本:1.0.0
点击home键
$act.home();
back()
版本:1.0.0
返回
$act.back();
menu()
版本:1.0.0
返回
$act.menu();
recent()
版本:1.0.0
近期任务
$act.recent();
power()
版本:1.0.0
长按电源
$act.power();
lock()
版本:1.0.0
锁屏
$act.lock();
unlock()
版本:1.0.0
唤醒屏幕
$act.unlock();
splitScreen()
版本:1.0.0
分屏
$act.splitScreen();
settings()
版本:1.0.0
设置
$act.settings();
notifications()
版本:1.0.0
通知
$act.notifications();
screenshot()
版本:1.0.0
截屏
$act.screenshot();
input(text)
版本:1.0.0
粘贴到文本框
- 参数 : text {String} 需要输入的文字
$act.input("我是要粘贴的内容");
input(node,text)
版本:1.0.0
粘贴到文本框
- 参数 : node {AccessibilityNodeInfo} 指定节点
- 参数 : text {String} 需要输入的文字
$act.input("我是要粘贴的内容");
activity()
版本:1.0.0
获得activity类名
- 返回 : activity类名
let name = $act.activity();
log("当前类名:" + name);
activity(callback)
版本:1.0.0
设置窗口变化监听
- 参数 : callback {(name)=>{}} 回调
//设置监听:
$act.activity((name) => {
log("当前界面==>" + name);
});
selector()
版本:1.0.0
创建一个ui选择器
- 返回 : {UiSelector} UI选择器
setDevDensity(density)
版本:1.0.0
设置开发环境的密度
注意:此函数用于全分辨率适配
- 参数 : density {float} 密度因子
setAdapt(usable)
版本:1.0.0
是否启动分辨率适配
- 参数 : usable {boolean} 启用分辨率适配