全局快捷事件

说明

全局模块中封装的快捷事件，不用区分是无障碍模式还是代理模式

代理节点设置

setAgentSupportNode 设置代理模式下获取节点方式

设置代理模式下获取节点方式
该方法仅对代理模式生效
EC 安卓 11.2.0+
该方法在启动代理服务之前调用，使用2和3 可以减少检测的特征
1的方式会出现 ruru检测出 AccessibilityManager.isEnabled，2和其他的方式不会出现
1的方式节点能力交强，2节点功能较弱，3 就没有节点功能
@param support 1 类似无障碍一样的方式， 2 shell dump的的方式，3 不开启节点服务
@return {boolean} true true代表成功 false代表失败

function main() {
  setAgentSupportNode("2");
}

main();

setShellDumpCompressed 代理模式dump压缩模式

需要在代理服务启动后才能调用该方法
设置代理模式下shell dump是否使用压缩模式
压缩模式下获取的节点数量更少，速度更快
该方法仅对代理模式生效
@param compressed 1 代表压缩，2代表不压缩
@return {boolean} true代表成功 false代表失败

function main() {
  setAgentSupportNode("2")
  startEnv()
  let a = setShellDumpCompressed(1);
  logd("setShellDumpCompressed " + a)
}

main();

手势事件模式

setGestureActionMode 设置手势模式事件

设置各种手势模式事件的操作类型，默认是异步,目前只对无障碍模式有效
@param mode 1 代表异步，2代表同步
@param bool true代表成功 false代表失败

function main() {
  setGestureActionMode(1);
  // setGestureActionMode(2);
}

main();

点击函数

clickPoint 坐标点击

执行条件：无障碍7.0以上或者手势执行为代理服务
点击坐标
@param x x坐标
@param y y坐标
@return {boolean|布尔型}

function main() {
  var result = clickPoint(100, 100);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

click 选择器点击

执行条件：无障碍7.0以上或者手势执行为代理服务
点击选择器
@param selectors 选择器对象
@return {boolean|布尔型}

function main() {
  var selector = text("我是文本");
  var result = click(selector);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

clickEx 无指针点击

执行条件：无障碍5.0以上或者手势执行为代理服务
无指针方式点击选择器，节点必须是可点击的才行(clickable = true)
@param selectors 选择器对象
@return {boolean|布尔型}

function main() {
  var selector = text("我是文本");
  var result = clickEx(selector);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

longClickEx 无指针长点击

执行条件：无障碍5.0以上或者手势执行为代理服务
无指针方式长点击选择器，节点必须是可点击的才行
@param selectors 选择器对象
@return {boolean|布尔型}

function main() {
  var selector = text("我是文本");
  var result = longClickEx(selector);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

clickRandom 选择器随机点击

执行条件：无障碍7.0以上或者手势执行为代理服务
随机点击选择器的任意元素
@param selectors 选择器对象
@return {boolean|布尔型}

function main() {
  var selector = text("我是文本");
  var result = clickRandom(selector);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

clickRandomEx 无指针随机点击

执行条件：无障碍5.0以上或者手势执行为代理服务
随机点击选择器的任意元素
@param selectors 选择器对象
@return {boolean|布尔型}

function main() {
  var selector = text("我是文本");
  var result = clickRandomEx(selector);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

clickRandomRect 区域随机点击

执行条件：无障碍7.0以上或者手势执行为代理服务
随机点击区域中的坐标
@param rect 区域对象
@return {boolean|布尔型}

function main() {
  var rect = new Rect();
  rect.left = 10;
  rect.right = 200;
  rect.top = 10;
  rect.bottom = 400;
  var result = clickRandomRect(rect);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

clickCenter 点击中心点

执行条件：无障碍7.0以上或者手势执行为代理服务
点击区域中的中心坐标
@param rect 区域对象
@return {boolean|布尔型}

function main() {
  var rect = new Rect();
  rect.left = 10;
  rect.right = 200;
  rect.top = 10;
  rect.bottom = 400;
  var result = clickCenter(rect);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

clickText 点击文本

执行条件：无障碍7.0以上或者手势执行为代理服务
点击文本
@param text 文本
@return {boolean|布尔型}

function main() {
  var result = clickText("设置");
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

longClick 选择器长点击

执行条件：无障碍7.0以上或者手势执行为代理服务
长点击选择器
@param selectors 选择器对象
@return {boolean|布尔型}

function main() {
  var selector = text("我是文本");
  var result = longClick(selector);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

longClickPoint 坐标长点击

执行条件：无障碍7.0以上或者手势执行为代理服务
长点击坐标
@param x x坐标
@param y y坐标
@return {boolean|布尔型}

function main() {
  var result = longClickPoint(100, 100);
  if (result) {
    toast("点击成功");
  } else {
    toast("点击失败");
  }
}

main();

press 坐标长按

长按住事件
适用版本(EC 5.15.0+)
@param x x坐标
@param y y坐标
@param delay 长按时间毫秒
@return {bool} true 成功 false 失败

function main() {
  var result = press(100, 100, 5000);
  if (result) {
    toast("长按成功");
  } else {
    toast("长按失败");
  }
}

main();

多点触摸

multiTouch 多点触摸

执行条件：无障碍7.0以上或者手势执行为代理服务
多点触摸
触摸参数: action :一般情况下按下为0，弹起为1，移动为2
x: X坐标
y: Y坐标
pointer：设置第几个手指触摸点，分别是 1，2，3等，代表第n个手指
delay: 该动作延迟多少毫秒执行，这个是值当前这个事件先延迟后执行
@param touch1 第1个手指的触摸点数组,例如： [{"action":0,"x":1,"y":1,"pointer":1,"delay":20},{"action":2,"x":1,"y":1,"pointer":1,"delay":20}]
@param touch2 第2个手指的触摸点数组
@param touch3 第3个手指的触摸点数组
@param timeout 多点触摸总执行的超时时间，单位是毫秒
@return boolean|布尔型

function main() {
  utils.openAppByName("视频");
  sleep(3000);
  //第一种数组式的写法
  var touch1 = [
    {"action": 0, "x": 500, "y": 1200, "pointer": 1, "delay": 1},
    {"action": 2, "x": 500, "y": 1100, "pointer": 1, "delay": 20},
    {"action": 2, "x": 500, "y": 1000, "pointer": 1, "delay": 20},
    {"action": 1, "x": 1, "y": 1, "pointer": 1, "delay": 20}
  ]
  //第二种链式调用方法
  var touch1 = MultiPoint
    .get()
    .action(0).x(500).y(1200).pointer(1).delay(1)
    .next()
    .action(2).x(500).y(1100).pointer(1).delay(1)
    .next()
    .action(2).x(500).y(1000).pointer(1).delay(1)
    .next()
    .action(2).x(500).y(900).pointer(1).delay(1)
    .next()
    .action(1).x(500).y(800).pointer(1).delay(1);
  var touch2 = MultiPoint
    .get()
    .action(0).x(300).y(1200).pointer(2).delay(1)
    .next()
    .action(2).x(300).y(1100).pointer(2).delay(1)
    .next()
    .action(2).x(300).y(1000).pointer(2).delay(1)
    .next()
    .action(2).x(300).y(900).pointer(2).delay(1)
    .next()
    .action(1).x(300).y(800).pointer(2).delay(1);
  var x = multiTouch(touch1, touch2, null, 30000);
  logd("xxs " + x);
}

main();

touchDown 执行按下

执行按下
适合EC 7.4.0+,安卓版本8+
@param x x坐标
@param y y坐标
@return 布尔型 true 代表成功 false代表失败

function main() {
  //整个动作需要配合使用,单独无效
  //按下
  touchDown(100, 100)
  sleep(50)
  //移动
  touchMove(100, 150)
  sleep(50)
  //移动
  touchMove(100, 200)
  sleep(50)
  //抬起
  touchUp(100, 200)
  sleep(200)
}

main();

touchMove 执行移动

执行移动
适合EC 7.4.0+,安卓版本8+
@param x x坐标
@param y y坐标
@return 布尔型 true 代表成功 false代表失败

function main() {
  //整个动作需要配合使用,单独无效
  //按下
  touchDown(100, 100)
  sleep(50)
  //移动
  touchMove(100, 150)
  sleep(50)
  //移动
  touchMove(100, 200)
  sleep(50)
  //抬起
  touchUp(100, 200)
  sleep(200)
}

main();

touchUp 执行弹起

执行弹起事件
适合EC 7.4.0+,安卓版本8+
@param x x坐标
@param y y坐标
@return 布尔型 true 代表成功 false代表失败

function main() {
  //整个动作需要配合使用,单独无效
  //按下
  touchDown(100, 100)
  sleep(50)
  //移动
  touchMove(100, 150)
  sleep(50)
  //移动
  touchMove(100, 200)
  sleep(50)
  //抬起
  touchUp(100, 200)
  sleep(200)
}

main();

resetAllTouchState 重置touch状态

重置touch状态
防止因为touch执行的时候外部原因中断导致的不能再次执行touch
无障碍模式不生效
适合EC 11.16.0+
@return {boolean} true 代表成功 false代表失败

function main() {
  resetAllTouchState();
  logd(touchDownEx(300,500,1));
  logd(touchMoveEx(300,500,1));
  sleep(2000)
  while(true){
    sleep(10)
    logd(touchDownEx(610,510,2));
    sleep(1000)
    logd(touchMoveEx(660,660,2));
    sleep(2000)
    logd(touchUpEx(710,710,2));
    sleep(2000)
  }
}

main();

touchDownEx 执行弹起

按下事件，带手指参数
无障碍模式手指参数不生效
适合EC 11.16.0+
@param x x坐标
@param y y坐标
@param pointerId 手指参数从1开始
@return {boolean} true 代表成功 false代表失败

function main() {
  resetAllTouchState();
  logd(touchDownEx(300,500,1));
  logd(touchMoveEx(300,500,1));
  sleep(2000)
  while(true){
    sleep(10)
    logd(touchDownEx(610,510,2));
    sleep(1000)
    logd(touchMoveEx(660,660,2));
    sleep(2000)
    logd(touchUpEx(710,710,2));
    sleep(2000)
  }
}

main();

touchMoveEx 执行弹起

移动事件，带手指参数
无障碍模式手指参数不生效
适合EC 11.16.0+
@param x x坐标
@param y y坐标
@param pointerId 手指参数从1开始
@return {boolean} true 代表成功 false代表失败

function main() {
  resetAllTouchState();
  logd(touchDownEx(300,500,1));
  logd(touchMoveEx(300,500,1));
  sleep(2000)
  while(true){
    sleep(10)
    logd(touchDownEx(610,510,2));
    sleep(1000)
    logd(touchMoveEx(660,660,2));
    sleep(2000)
    logd(touchUpEx(710,710,2));
    sleep(2000)
  }
}

main();

touchUpEx 执行弹起

抬起事件，带手指参数
无障碍模式手指参数不生效
适合EC 11.16.0+
@param x x坐标
@param y y坐标
@param pointerId 手指参数从1开始
@return {boolean} true 代表成功 false代表失败

function main() {
  resetAllTouchState();
  logd(touchDownEx(300,500,1));
  logd(touchMoveEx(300,500,1));
  sleep(2000)
  while(true){
    sleep(10)
    logd(touchDownEx(610,510,2));
    sleep(1000)
    logd(touchMoveEx(660,660,2));
    sleep(2000)
    logd(touchUpEx(710,710,2));
    sleep(2000)
  }
}

main();

滚动函数

scrollForward 无指针向前滚动

执行条件：无障碍5.0以上或者手势执行为代理服务
向前滚动
@param selectors 选择器对象
@return {boolean|布尔型}

function main() {
  var selector = scrollable(true);
  var result = scrollForward(selector);
  if (result) {
    toast("滚动成功");
  } else {
    toast("滚动失败");
  }
}

main();

scrollBackward 无指针向后滚动

执行条件：无障碍5.0以上或者手势执行为代理服务
向后滚动
@param selectors 选择器对象
@return {boolean|布尔型}

function main() {
  var selector = scrollable(true);
  var result = scrollBackward(selector);
  if (result) {
    toast("滚动成功");
  } else {
    toast("滚动失败");
  }
}

main();

滑动函数

swipe 滑动

执行条件：无障碍7.0以上或者手势执行为代理服务
通过选择器滑动节点
@param selectors 节点选择器
@param endX 结束的X坐标
@param endY 结束的Y坐标
@param duration 持续时长单位毫秒
@return 布尔型 true 代表成功 false 代表失败

function main() {
  var selectors = text("我是文本");
  var result = swipe(selectors, 100, 100, 200);
  if (result) {
    toast("滑动成功");
  } else {
    toast("滑动失败");
  }
}

main();

swipeToPoint 坐标点滑动

执行条件：无障碍7.0以上或者手势执行为代理服务
从一个坐标滑动到另一个坐标
@param startX 起始坐标的X轴值
@param startY 起始坐标的Y轴值
@param endX 结束坐标的X轴值
@param endY 结束坐标的Y轴值
@param duration 持续时长单位毫秒
@return 布尔型 true 滑动成功, false 滑动失败

function main() {
  var result = swipeToPoint(10, 10, 100, 100, 200);
  if (result) {
    toast("滑动成功");
  } else {
    toast("滑动失败");
  }
}

main();

isScrollEnd 滚到底部判断

执行条件：无障碍5.0以上或者手势执行为代理服务
是否滚动到底部了，如果查不到元素也会返回false
@param distance 滚动方向 UP,DOWN,LEFT,RIGHT
@param selectors 选择器
@return false 代表未滚动到位，true 代表滚动完成了

function main() {
  var selectors = clz("android.widget.ListView");
  var result = isScrollEnd("UP", selectors);
  if (result) {
    toast("滚动完成");
  } else {
    toast("滚动未完成");
  }
}

main();

拖动函数

drag 拖动坐标

执行条件：无障碍7.0以上或者手势执行为代理服务
从一个坐标到另一个坐标的拖动
@param startX 起始坐标的X轴值
@param startY 起始坐标的Y轴值
@param endX 结束坐标的X轴值
@param endY 结束坐标的Y轴值
@param duration 持续时长单位毫秒
@return 布尔型 true 拖动成功, false 拖动失败

function main() {
  var result = drag(10, 10, 100, 100, 200);
  if (result) {
    toast("拖动成功");
  } else {
    toast("拖动失败");
  }
}

main();

dragTo 拖动选择器

执行条件：无障碍7.0以上或者手势执行为代理服务
通过选择器拖动某个元素到目标元素
@param selectors 选择器
@param destObj 目标元素选择器
@param duration 持续时长单位毫秒
@return 布尔型 true 成功 false 失败

function main() {
  var selectors = text("设置");
  var destObj = text("日历");
  var result = dragTo(selectors, destObj, 200);
  if (result) {
    toast("拖动成功");
  } else {
    toast("拖动失败");
  }
}

main();

dragToPoint 拖动到目标选择器

执行条件：无障碍7.0以上或者手势执行为代理服务
通过选择器拖动某个元素到目标X Y 坐标
@param selectors 原始元素选择器
@param endX 目标 X 坐标
@param endY 目标 Y 坐标
@param duration 持续时长单位毫秒
@return 布尔型 true 成功 false 失败

function main() {
  var selectors = text("设置");
  var result = dragToPoint(selectors, 100, 100, 200);
  if (result) {
    toast("拖动成功");
  } else {
    toast("拖动失败");
  }
}

main();

输入数据

imeInputViewShown 输入法键盘是否展示

使用输入法输入内容时，输入法键盘视图是否展示出来
前提：在EC 系统设置中，勾选了显示输入法键盘
适配EC 9.18.0+
@return {boolean|布尔型} true代表视图展示 false代表未展示

function main() {
  var result = imeInputViewShown();
  if (result) {
    toast("是");
  } else {
    toast("否");
  }
}

main();

currentIsOurIme 是否是自带输入法

当前是否是我们的输入法
@return {boolean|布尔型}

function main() {
  var result = currentIsOurIme();
  if (result) {
    toast("是");
  } else {
    toast("否");
  }
}

main();

inputText 输入数据

执行条件：无障碍5.0以上
通过选择器输入数据
@param selectors 选择器
@param content 数据字符串
@return {boolean|布尔型}

function main() {
  var selectors = clz("android.widget.EditText");
  var result = inputText(selectors, "我是内容");
  if (result) {
    toast("是");
  } else {
    toast("否");
  }
}

main();

imeInputText 输入法输入数据

使用输入法输入内容，前提是已经设置本程序的输入法为默认输入法
适合没有节点的情况，例如游戏等
@param selectors 选择器，可以为空，如果为空，前提是输入框是聚焦的状态
@param content 数据字符串, 特殊字符串解释： --ec_close_input-- 关闭软键盘，--ec_open_input-- 打开软键盘；--ec_show_input_view-- 显示键盘的视图，--ec_hide_input_view-- 不显示键盘的视图
@return {boolean|布尔型}

function main() {

  // 打开软键盘
  //imeInputText(null, "--ec_open_input--");

  var selectors = clz("android.widget.EditText");
  var result = imeInputText(selectors, "我是内容");

  if (result) {
    toast("是");
  } else {
    toast("否");
  }
}

main();

imeInputKeyCode 输入法输入code

使用输入法输入内容，前提是已经设置本程序的输入法为默认输入法
适合没有节点的情况，例如游戏等
@param selectors 选择器，可以为空，如果为空，前提是输入框是聚焦的状态
@param content 具体请看 KeyEvent.KEYCODE_*的值，例如66 = enter 67=del,84=SEARCH
特殊代码： 1000: 模拟搜索按键，1001: 模拟完成按键 1002:模拟go按键，1003:模拟下一个按键，1004:模拟上一个按键 1005:模拟发送按键
@return {boolean|布尔型}

function main() {
  // 模拟搜索按键
  // imeInputKeyCode(null,1000);
  var selectors = clz("android.widget.EditText");
  var result = imeInputKeyCode(selectors, 66);
  if (result) {
    toast("是");
  } else {
    toast("否");
  }
}

main();

pasteText 粘贴数据

执行条件：无障碍5.0以上
通过选择器粘贴数据
@param selectors 选择器
@param content 数据字符串
@return {boolean|布尔型}

function main() {
  var selectors = clz("android.widget.EditText");
  var result = pasteText(selectors, "我是内容");
  if (result) {
    toast("是");
  } else {
    toast("否");
  }
}

main();

clearTextField 清除数据

执行条件：无障碍5.0以上
@param selectors 节点选择器
@return {boolean|布尔型}

function main() {
  var selectors = clz("android.widget.EditText");
  var result = clearTextField(selectors);
  if (result) {
    toast("是");
  } else {
    toast("否");
  }
}

main();

节点操作

lastNodeEventTime 最近节点事件发生时间

适用版本(EC 5.14.0+)
获取最近的节点事件触发的时间，可通过时间判断节点服务是否可用
@return {long} 长整型时间，毫秒级别

function main() {
  startEnv();
  logd("开始监听");

  while (true) {
    let d = lastNodeEventTime();
    logd("time-" + d);
    sleep(1000)
  }
}

main();

setFocus 设置节点聚焦

设置节点聚焦
适配EC 10.21.0+
@param selectors 选择器对象
@return boolean|布尔型

function main() {
  var selectors = text("设置");
  var result = setFocus(selectors);
  if (result) {
    toast("ok");
  } else {
    toast("false");
  }
}

main();

has 节点存在判断

通过选择器判断元素是否存在
@param selectors 选择器
@return {null|布尔型}

function main() {
  var selectors = text("设置");
  var result = has(selectors);
  if (result) {
    toast("存在节点");
  } else {
    toast("不存在节点");
  }
}

main();

waitExistActivity 等界面出现

等待activity界面出现
@param activity 界面名称
@param timeout 超时时间，单位毫秒
@return {null|布尔型}

function main() {
  var ac = "com.xxx.MainActivity";
  var result = waitExistActivity(ac, 10000);
  if (result) {
    toast("存在界面");
  } else {
    toast("不存在界面");
  }
}

main();

waitExistNode 等节点出现

通过选择器判断并等待元素是否存
@param selectors 选择器
@param timeout 超时时间，单位毫秒
@return {null|布尔型}

function main() {
  var selectors = text("设置");
  var result = waitExistNode(selectors, 10000);
  if (result) {
    toast("存在节点");
  } else {
    toast("不存在节点");
  }
}

main();

getText 获取文本

获取选择器得到的文本数据
@param selectors 选择器
@return {字符串数组|null|字符串集合}

function main() {
  var selectors = clz("android.widget.TextView");
  var result = getText(selectors);
  toast("result:" + result);
}

main();

getNodeInfo 获取节点数组

获取节点信息
@param selectors 选择器
@param timeout 等待时间，单位是毫秒
@return {null|NodeInfo数组|节点信息集合}

function main() {
  var result = getNodeInfo(clz("android.widget.TextView"), 10 * 1000);
  toast("result:" + JSON.stringify(result));
}

main();

getNodeAttrs 节点属性信息

获取节点属性信息
@param selectors 选择器
@param attr 属性值,例如 text,className，更多的属性请参考NodeInfo对象属性
@return {null|字符串数组|Rect对象数组}

function main() {
  var selectors = clz("android.widget.TextView");
  //获取所有text属性
  var result = getNodeAttrs(selectors, "text");
  toast("result:" + result);
  //获取所有bounds属性
  result = getNodeAttrs(selectors, "bounds");
  toast("result:" + result);
}

main();

getOneNodeInfo 获取单个节点

通过选择器获取第一个节点信息
@param selectors 选择器
@param timeout 等待时间，单位是毫秒
@return NodeInfo 对象或者null

function main() {
  var result = getOneNodeInfo(clz("android.widget.TextView"), 10 * 1000);
  toast("result:" + JSON.stringify(result));
  if (result) {
    result.click();
  }
}

main();

setFetchNodeMode 获取节点的模式

设置获取节点的模式
@param mode 1 是增强型， 2 是快速型，默认是增强型
@param fetchInvisibleNode 是否抓取隐藏的元素，默认不抓取
@param fetchNotImportantNode 是否抓取不重要的元素，默认抓取
@param algorithm 节点查找算法,默认是nsf，分别有 nsf = 节点静态算法，bsf= 广度优先， dsf=深度度优先
@return {boolean}

function main() {
  // 脚本开头执行一次即可
  var result = setFetchNodeMode(1, false, true, "nsf");
  toast("result:" + result);
}

main();

setNodeDumpParam 设置nsf抓节点参数

设置nsf抓节点参数
部分手机上使用NSF 读取节点会导致stackoverflow异常，可以使用dumpMethod设置为2或者3进行改善
maxDepth参数用于控制节点深度，可以提高速度
适配EC 10.9.0+
不同的深度、抓节点方式，可以增加速度以及节点过多防止内存溢出问题
@param data map格式 {"dumpMethod":1,"maxDepth":50}
dumpMethod: NSF算法下的抓节点方式分别是1、2、3，默认是1
maxDepth: 抓节点深度
@return boolean|布尔型

function main() {
  // 脚本开头执行一次即可
  var result = setNodeDumpParam(1, false, true, "nsf");
  toast("result:" + result);
  logd(dumpXml())
}

main();

setBlockNodeAttr 屏蔽节点属性

设置要屏蔽的节点属性
设置后，系统不会抓取这些节点数据属性
适配 EC 9.23.0+
@param blockNode 字符串，以英文逗号分割，例如 clz,index,bounds，获取属性值，参考idea节点面板的右侧属性
blockNode 设置为 "" , 代表恢复默认
@return {boolean}

function main() {
  var result = setBlockNodeAttr("row,bounds,index");
  toast("result:" + result);
  let data = dumpXml()
  logd(data)

  // 恢复默认
  setBlockNodeAttr("")
}

main();

addNodeFlag 加上节点获取的某个标志位

加上节点获取的某个标志位
@param flag 参见 AccessibilityServiceInfo.FLAG_*，如果是0是强制刷新
@return {null|boolean}

function main() {
  addNodeFlag(0);
}

main();

removeNodeFlag 移除节点获取的某个标志位[强制刷新节点]

移除节点获取的某个标志位
@param flag 参见 AccessibilityServiceInfo.FLAG_*，如果是0是强制刷新

function main() {
  removeNodeFlag(0);
}

main();

dumpXml 元素变XML

将元素节点变成XML
@return string string|null

function main() {
  var result = dumpXml();
  if (result) {
    toast("ok");
  } else {
    toast("no");
  }
}

main();

lockNode 锁定当前节点

锁定当前节点，锁定后，后面就算界面刷新，但是节点还是老的信息，需要和releaseNode进行配合才能进行解锁

function main() {
  logd("锁住节点...")
  //锁住节点，界面刷新也不动
  console.time("1")
  lockNode()
  for (let i = 0; i < 10; i++) {
    let n = text("设置").getOneNodeInfo(1000)
    logd("lock " + n)
  }
  logd("释放节点锁...")
  //释放节点锁
  releaseNode()
  logd(console.timeEnd("1"))

  console.time("1")
  for (var i = 0; i < 10; i++) {
    let n = text("设置").getOneNodeInfo(1000)
    logd("unlocked " + n)
  }
  logd(console.timeEnd("1"))
  //锁住时间明显更短
}

main();

releaseNode 释放节点的锁

释放节点的锁，释放后，当界面刷新的时候，节点信息会变成最新的

function main() {
  logd("锁住节点...")
  //锁住节点，界面刷新也不动
  console.time("1")
  lockNode()
  for (let i = 0; i < 10; i++) {
    let n = text("设置").getOneNodeInfo(1000)
    logd("lock " + n)
  }
  logd("释放节点锁...")
  //释放节点锁
  releaseNode()
  logd(console.timeEnd("1"))

  console.time("1")
  for (var i = 0; i < 10; i++) {
    let n = text("设置").getOneNodeInfo(1000)
    logd("unlocked " + n)
  }
  logd(console.timeEnd("1"))
  //锁住时间明显更短
}

main();

系统按键相关

home 返回主页

执行条件：无障碍5.0以上或者手势执行为代理服务
返回主页
@return {null|布尔型}

function main() {
  var result = home();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

home2 返回主页2

返回主页，无需权限和自动化
适配EC 安卓9.16.0+
@return {null|布尔型}

function main() {
  var result = home2();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

splitScreen 分割屏幕

执行条件：无障碍5.0以上或者手势执行为代理服务
适用版本(EC 5.15.0+)
返回主页
@return {null|布尔型}

function main() {
  var result = splitScreen();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

power 模拟电源按键

执行条件：无障碍5.0以上或者手势执行为代理服务
模拟电源按键，无障碍是电源对话框，代理模式是电源键按下
@return {null|布尔型}

function main() {
  var result = power();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

back 返回键

执行条件：无障碍5.0以上或者手势执行为代理服务
返回键
@return {null|布尔型}

function main() {
  var result = back();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

openNotification 打开通知栏

执行条件：无障碍5.0以上或者手势执行为代理服务
打开通知栏
@return {null|布尔型}

function main() {
  var result = openNotification();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

openQuickSettings 打开快速设置

执行条件：无障碍5.0以上或者手势执行为代理服务
打开快速设置
@return {null|布尔型}

function main() {
  var result = openQuickSettings();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

recentApps 最近APP任务按键

执行条件：无障碍5.0以上或者手势执行为代理服务
最近APP任务按键
@return {null|布尔型}

function main() {
  var result = recentApps();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

getCurrentRunningPkg 当前运行的App包名

取得当前运行的App包名
这个是通过节点获取的，前提是需要打开自动化服务
适配EC 10.6.0+
@return string

function main() {
  var result = getCurrentRunningPkg();
  logd(result)
}

main();

getRunningPkg 当前运行的App包名

这个获取的不准确，已经废弃了
取得当前运行的App包名
@return {字符串|null}

function main() {
  var result = getRunningPkg();
}

main();

getRunningActivity 当前运行的Activity类名

取得当前运行的Activity类名
@return {字符串|null}

function main() {
  var result = getRunningActivity();
}

main();

lockScreen 锁屏

参考performGlobalAction 函数
适配EC 安卓 11.12.0+
@return {boolean} 布尔型| true代表成功

function main() {
  var result = lockScreen();
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

performGlobalAction 执行全局的action动作

执行全局的action动作
适配EC 安卓 11.12.0+
@param actionType 这个值请参考AccessibilityService下面的global开头的常量，例如：
public static final int GLOBAL_ACTION_BACK = 1;
public static final int GLOBAL_ACTION_HOME = 2;
public static final int GLOBAL_ACTION_LOCK_SCREEN = 8;
public static final int GLOBAL_ACTION_NOTIFICATIONS = 4;
public static final int GLOBAL_ACTION_POWER_DIALOG = 6;
public static final int GLOBAL_ACTION_QUICK_SETTINGS = 5;
public static final int GLOBAL_ACTION_RECENTS = 3;
public static final int GLOBAL_ACTION_TAKE_SCREENSHOT = 9;
public static final int GLOBAL_ACTION_TOGGLE_SPLIT_SCREEN = 7;
@return {boolean} 布尔型| true代表成功

function main() {
  var result = performGlobalAction(8);
  if (result) {
    toast("成功");
  } else {
    toast("失败");
  }
}

main();

通知栏

requestNotificationPermission 请求监听状态栏的权限

请求监听状态栏的权限
@param timeout 请求权限超时时间单位是秒
@return true 代表请求权限成功，false代表失败

function main() {
  var result = requestNotificationPermission(10);
  toast("是否有权限:" + result);
}

main();

hasNotificationPermission 是否有状态栏监听权限

检查是否含有状态栏监听权限
@return true 代表请求权限成功，false代表失败

function main() {
  var result = hasNotificationPermission();
  toast("是否有权限:" + result);
}

main(); 

getLastNotification 获取最近通知栏对象

获取最近通知栏对象
@param pkg 指定包名
@param size 指定获取的条数
@return {NotificationInfo数组}

function main() {
  var result = getLastNotification("com.x", 100);
  toast("结果:" + result);
}

main();

shotNotification 通知发射处理

将通知发射处理，相当于点击了通知栏
@param seqId
@return {boolean|布尔型}

function main() {
  var result = getLastNotification("com.x", 1);
  if (result && result.length > 0) {
    var s = shotNotification(result[0].seqId);
    toast("结果:" + s);
  }
}

main();

ignoreNotification 忽略通知

忽略通知，从缓存队列移除，下次将不会获取
@param seqId
@return {boolean|布尔型}

function main() {
  var result = getLastNotification("com.x", 1);
  if (result != null && result.length > 0) {
    var s = ignoreNotification(result[0].seqId);
    toast("结果:" + s);
  }
}

main();

cancelNotification 取消通知

将通知进行取消操作
@param seqId
@return {boolean|布尔型}

function main() {
  var result = getLastNotification("com.x", 1);
  if (result != null && result.length > 0) {
    var s = cancelNotification(result[0].seqId);
    toast("结果:" + s);
  }
}

main();

getLastToast 获取toast数据

获取toast数据
@param pkg 指定包名
@param size 指定获取的条数
@return {null|ToastInfo数组}

function main() {
  let result = getLastToast("com.xx", 100);
  toast("结果:" + JSON.stringify(result));
  if (result && result.length > 0) {
    for (let i = 0; i < result.length; i++) {
      logd(result[i])
    }
  }
}

main();

悬浮窗日志

requestFloatViewPermission 请求浮窗权限

请求展示浮窗的权限
@param timeout 请求权限超时时间单位是秒
@return true 代表请求权限成功，false代表失败

function main() {
  var result = requestFloatViewPermission(10);
  toast("是否有权限:" + result);
}

main();

hasFloatViewPermission 检查浮窗权限

检查是否含有浮窗权限
@return true 代表请求权限成功，false代表失败

function main() {
  var result = hasFloatViewPermission();
  toast("是否有权限:" + result);
}

main();

showFloatView 展示浮窗

展示浮窗（如果是开发工具调试，请先预览一下工程，然后运行脚本，避免读取不到path文件内容的情况）
@param params js的map对象，包含的
var map = {"path":"main.html","tag":"test"}; 类似这样的参数
参数解析:
tag:字符串悬浮窗唯一定位的标示
path:字符串 IEC 中的布局文件
title:字符串悬浮窗标题
titleBg:字符串悬浮窗背景，16进制，例如#888888，或者#88000000
x:整型悬浮窗起始X坐标
y:整型悬浮窗起始Y坐标
w:整型悬浮窗起始宽度
h:整型悬浮窗起始高度
@return true 代表请求权限成功，false代表失败

function main() {
  var m = {
    "path": "main.html",
    "tag": "tag",
    "title": "sss",
    "titleBg": "#888888",
    "x": 10,
    "y": 10,
    "w": 100,
    "h": 200
  };
  var xd = showFloatView(m);
  logd("showFloatView " + xd);
}

main();

closeFloatView 关闭浮窗

关闭浮窗
@param tag showFloatView 使用的tag参数，对悬浮窗唯一定位的
@return true 成功，false代表失败

function main() {
  var m = {
    "path": "main.html",
    "tag": "tag",
    "title": "sss",
    "titleBg": "#888888",
    "x": 10,
    "y": 10,
    "w": 100,
    "h": 200
  };
  var xd = showFloatView(m);
  logd("showFloatView " + xd);
  sleep(3000);
  closeFloatView("tag");
}

main();

closeAllFloatView 关闭所有悬浮窗

关闭所有悬浮窗，但不包含日志悬浮窗
@return true 成功，false代表失败

function main() {
  var m = {
    "path": "main.html",
    "tag": "tag",
    "title": "sss",
    "titleBg": "#888888",
    "x": 10,
    "y": 10,
    "w": 100,
    "h": 200
  };
  var xd = showFloatView(m);
  logd("showFloatView " + xd);
  sleep(3000);
  closeAllFloatView();
}

main();

showScriptCtrlFloatView 显示脚本暂停控制悬浮窗

显示脚本暂停控制悬浮窗
适配EC 10.0.0+

function main() {
  showScriptCtrlFloatView();
}

main();

closeScriptCtrlFloatView 关闭脚本暂停控制悬浮窗

关闭脚本暂停控制悬浮窗
适配EC 10.0.0+

function main() {
  closeScriptCtrlFloatView();
}

main();

showCtrlWindow 展示启停浮窗

展示启停浮窗
@return true 代表请求权限成功，false代表失败

function main() {
  var result = showCtrlWindow();
  toast("是否展示:" + result);
}

main();

closeCtrlWindow 关闭启停浮窗

关闭启停浮窗
@return true 代表请求权限成功，false代表失败

function main() {
  var result = closeCtrlWindow();
  toast("是否展示:" + result);
}

main();

setCtrlViewSizeEx 设置启停控制窗口

设置启停控制窗口参数
适用版本(EC 6.5.0+)
@param map 例如

{
  "x": 100,
  "y": 100,
  "backgroundColor": "#ffffff"
}
//解释：
//  x: 起始X位置
//  y: 起始Y位置

@return bool true代表成功，false代表失败

function main() {
  requestFloatViewPermission(1000);
  var m = {
    "x": 100,
    "y": 200,
    "backgroundColor": "#ffffff"
  }
  showCtrlWindow();
  setCtrlViewSizeEx(m);
  sleep(5000);
}

main();

showLogWindow 展示日志浮窗

展示日志浮窗
@return true 代表请求权限成功，false代表失败

function main() {
  var result = showLogWindow();
  toast("是否展示:" + result);
}

main();

closeLogWindow 关闭日志浮窗

关闭日志浮窗
@return true 代表请求权限成功，false代表失败

function main() {
  closeLogWindow();
}

main();

setLogViewSizeEx 设置日志窗口

设置日志窗口大小扩展函数
backgroundImg适用版本(EC 6.0.0+)
@param map 例如

提示

{
  "x": 100,
  "y": 100,
  "w": 100,
  "h": 200,
  "textSize": 12,
  "backgroundColor": "#ffffff",
  "backgroundImg": "res/a.png",
  "title": "我是日志",
  "backgroundAlpha": 255,
  "showTitle": true,
  "canTouch": false,
  "gravity": "center",
  "showCloseBtn": true
}

x: 起始X位置
y: 起始Y位置
w: 宽度
h: 高度
textSize: 日志的字体大小
backgroundColor:背景颜色，例如#336699
title: 日志框标题
showTitle：是否显示标题
gravity: 标题的位置，分别是start:靠左，center:居中，end: 靠右
backgroundImg 背景图片, 支持GIF动画，放到工程的res文件夹，录入填写res/a.png
backgroundAlpha 背景图的透明度 255 - 0
9.33.0+新增参数:
- canTouch: 代表是否可以触摸，包含移动点击等悬浮窗事件，false代表脚本运行期间不可以触摸，默认是false，具有穿透作用，true代表脚本运行期间可以接受事件
- showCloseBtn: 是否显示关闭按钮，false不显示 true显示

@return bool true代表成功，false代表失败

function main() {
  requestFloatViewPermission(1000);
  var m = {
    "x": 100,
    "y": 200,
    "w": 600,
    "h": 600,
    "gravity": "center",
    "textSize": 12,
    "backgroundColor": "#ffffff",
    "title": "我是日222志",
    "showTitle": false
  }

  showLogWindow();
  sleep(2000);
  setLogViewSizeEx(m);
  sleep(5000);
}

main();

setLogFixedViewEx 设置日志固定栏目属性

设置日志顶部固定窗口属性
适合EC 6.17.0+
@param param map参数

解释:

show: 是否展示
h: 高度必须大于0
textSize: 日志的字体大小
backgroundColor: 背景颜色，例如#336699

function main() {
  requestFloatViewPermission(1000);
  var m = {
    "show": true,
    "h": 150,
    "textSize": 12,
    "textColor": "#000000",
    "backgroundColor": "#ffffff"
  }
  showLogWindow();
  sleep(1000)
  setLogFixedViewEx(m);
  setFixedViewText("TEST\n都是对的")

  sleep(5000);


}

main();

setFixedViewText 展示固定消息

展示消息到悬浮窗固定的视图中
@param msg 消息

function main() {
  requestFloatViewPermission(1000);
  var m = {
    "show": true,
    "h": -1,
    "textSize": 12,
    "backgroundColor": "#ffffff"
  }
  showLogWindow();
  sleep(1000)
  setLogFixedViewEx(m);
  sleep(1000);
  setFixedViewText("TEST")
}

main();

setLogText 展示消息

展示消息到悬浮窗日志中
@param msg 消息
@param color 颜色值例如 #ffffff
@param size 字体大小

function main() {
  var result = setLogText("开始运行...", "#ffffff", 18);
}

main();

expandLogView 展开日志悬浮窗

展开日志悬浮窗
适配EC 9.32.0+
@return true 成功，false代表失败

function main() {
  showLogWindow();
  sleep(1000)
  var result = expandLogView();
}

main();

collapseLogView 折叠日志悬浮窗

折叠日志悬浮窗，只保留标题
适配EC 9.32.0+
@return true 成功，false代表失败

function main() {
  showLogWindow();
  sleep(1000)
  var result = collapseLogView();
}

main();

定时任务

startJob 开启定时

开启一个定时脚本任务
@param tag 任务的唯一标示，不能为空，脚本中可以使用readConfigString("jobTaskTag")获取当前tag值，判断是那个任务过来执行的
@param execTime 定时时间格式: 2020-04-17 19:20:00，或者直接是秒数字，例如 3，代表3秒后
@param cancelBeforeRunning
@return 整型 jobid
提示
只能执行整个脚本,不能指定某个函数 :::

function main() {
  var time = "2020-04-17 09:00:00";
  //使用日期开启一个任务
  var id = startJob("task1", time, true);
  logd("job id " + id);
  //使用秒数开启，60秒后执行一个任务
  var id2 = startJob("task2", "60", true);
  logd("job id " + id2);
}

main();

cancelAllJob 取消所有定时

取消所有定时
@return bool true 代表有任务被取消

function main() {
  var result = cancelAllJob();
  logd(result);
}

main();

cancelJob 取消指定TAG定时

通过tag对定时任务进行取消
@param tag tag名称，startJob的时候tag参数的值
@return bool true 代表有任务被取消

function main() {

  var result = cancelJob("task1");
  logd(result);
}

main();

getAllJobTag 获取所有定时标签

取得所有的定时任务标签
@return 字符串数组或者null

function main() {
  var result = getAllJobTag();
  logd(result);
}

main();

动态权限申请

tryGetProjectionPermission 获取截图自允许权限

获取截图自允许权限
代理模式忽略这函数，这个适合弹窗权限截图模式
适配EC 10.25.0+
在有shell或者root权限执行，申请完毕可以关闭shell和root
尝试获取截图自动允许权限，申请截图不会弹窗
@return bool true 代表成功 false代表失败

function main() {
  let result = tryGetProjectionPermission()
  logd(result);
  // 接下来就可以进行申请截图权限了
}

main();

tryGetAccStartupPermission 获取无障碍自允许权限

获取无障碍自允许权限
有权限后无障碍可以自动启动
适配EC 10.25.0+
在有shell或者root权限执行申请，申请完毕可以关闭shell和root
尝试获取无障碍自动化允许的权限
@return bool true 代表成功 false代表失败

function main() {
  let result = tryGetAccStartupPermission()
  logd(result);
  // 接下来就可以进行无障碍自动启动
  startEnv();
}

main();

requestRuntimePermission 申请动态权限

申请动态权限
适合版本 EC 7.9.0+
@param permissionArray 动态权限数组，可以是多个
@timeout 申请超时时间单位是毫秒
@return {bool} true 代表有权限 false代表无权限或申请失败

function main() {
  let per = [
    "android.permission.READ_CALENDAR",
    "android.permission.READ_SMS"
  ]
  let result = requestRuntimePermission(per, 10000)
  logd(result);
}

main();

其他函数

random 随机函数

取得某个范围的随机值
@param min 最小值
@param max 最大值
@return 整型在min和max中间的值, 包含最大和最小值

function main() {
  var result = random(100, 1000);
  sleep(result);
}

main();

isReleaseIec 脚本是否是release版本

判断脚本是否是release版本
适配EC 11.12.0+
@return {boolean} true 是发布版本脚本 false 是debug版本

function main() {
  var result = isReleaseIec();
  logd(result)
}

main();

说明​

代理节点设置​

setAgentSupportNode 设置代理模式下获取节点方式​

setShellDumpCompressed 代理模式dump压缩模式​

手势事件模式​

setGestureActionMode 设置手势模式事件​

点击函数​

clickPoint 坐标点击​

click 选择器点击​

clickEx 无指针点击​

longClickEx 无指针长点击​

clickRandom 选择器随机点击​

clickRandomEx 无指针随机点击​

clickRandomRect 区域随机点击​

clickCenter 点击中心点​

clickText 点击文本​

longClick 选择器长点击​

longClickPoint 坐标长点击​

press 坐标长按​

多点触摸​

multiTouch 多点触摸​

touchDown 执行按下​

touchMove 执行移动​

touchUp 执行弹起​

resetAllTouchState 重置touch状态​

touchDownEx 执行弹起​

touchMoveEx 执行弹起​

touchUpEx 执行弹起​

滚动函数​

scrollForward 无指针向前滚动​

scrollBackward 无指针向后滚动​

滑动函数​

swipe 滑动​

swipeToPoint 坐标点滑动​

isScrollEnd 滚到底部判断​

拖动函数​

drag 拖动坐标​

dragTo 拖动选择器​

dragToPoint 拖动到目标选择器​

输入数据​

imeInputViewShown 输入法键盘是否展示​

currentIsOurIme 是否是自带输入法​

inputText 输入数据​

imeInputText 输入法输入数据​

imeInputKeyCode 输入法输入code​

pasteText 粘贴数据​

clearTextField 清除数据​

节点操作​

lastNodeEventTime 最近节点事件发生时间​

setFocus 设置节点聚焦​

has 节点存在判断​

waitExistActivity 等界面出现​

waitExistNode 等节点出现​

getText 获取文本​

getNodeInfo 获取节点数组​

getNodeAttrs 节点属性信息​

getOneNodeInfo 获取单个节点​

setFetchNodeMode 获取节点的模式​

setNodeDumpParam 设置nsf抓节点参数​

setBlockNodeAttr 屏蔽节点属性​

addNodeFlag 加上节点获取的某个标志位​

removeNodeFlag 移除节点获取的某个标志位[强制刷新节点]​

dumpXml 元素变XML​

lockNode 锁定当前节点​

releaseNode 释放节点的锁​

系统按键相关​

home 返回主页​

home2 返回主页2​

splitScreen 分割屏幕​

power 模拟电源按键​

back 返回键​

openNotification 打开通知栏​

openQuickSettings 打开快速设置​

recentApps 最近APP任务按键​

getCurrentRunningPkg 当前运行的App包名​

getRunningPkg 当前运行的App包名​

getRunningActivity 当前运行的Activity类名​

lockScreen 锁屏​

performGlobalAction 执行全局的action动作​

通知栏​

说明

代理节点设置

setAgentSupportNode 设置代理模式下获取节点方式

setShellDumpCompressed 代理模式dump压缩模式

手势事件模式

setGestureActionMode 设置手势模式事件

点击函数

clickPoint 坐标点击

click 选择器点击

clickEx 无指针点击

longClickEx 无指针长点击

clickRandom 选择器随机点击

clickRandomEx 无指针随机点击

clickRandomRect 区域随机点击

clickCenter 点击中心点

clickText 点击文本

longClick 选择器长点击

longClickPoint 坐标长点击

press 坐标长按

多点触摸

multiTouch 多点触摸

touchDown 执行按下

touchMove 执行移动

touchUp 执行弹起

resetAllTouchState 重置touch状态

touchDownEx 执行弹起

touchMoveEx 执行弹起

touchUpEx 执行弹起

滚动函数

scrollForward 无指针向前滚动

scrollBackward 无指针向后滚动

滑动函数

swipe 滑动

swipeToPoint 坐标点滑动

isScrollEnd 滚到底部判断

拖动函数

drag 拖动坐标

dragTo 拖动选择器

dragToPoint 拖动到目标选择器

输入数据

imeInputViewShown 输入法键盘是否展示

currentIsOurIme 是否是自带输入法

inputText 输入数据

imeInputText 输入法输入数据

imeInputKeyCode 输入法输入code

pasteText 粘贴数据

clearTextField 清除数据

节点操作

lastNodeEventTime 最近节点事件发生时间

setFocus 设置节点聚焦

has 节点存在判断

waitExistActivity 等界面出现

waitExistNode 等节点出现

getText 获取文本

getNodeInfo 获取节点数组

getNodeAttrs 节点属性信息

getOneNodeInfo 获取单个节点

setFetchNodeMode 获取节点的模式

setNodeDumpParam 设置nsf抓节点参数

setBlockNodeAttr 屏蔽节点属性

addNodeFlag 加上节点获取的某个标志位

removeNodeFlag 移除节点获取的某个标志位[强制刷新节点]

dumpXml 元素变XML

lockNode 锁定当前节点

releaseNode 释放节点的锁

系统按键相关

home 返回主页

home2 返回主页2

splitScreen 分割屏幕

power 模拟电源按键

back 返回键

openNotification 打开通知栏

openQuickSettings 打开快速设置

recentApps 最近APP任务按键

getCurrentRunningPkg 当前运行的App包名

getRunningPkg 当前运行的App包名

getRunningActivity 当前运行的Activity类名

lockScreen 锁屏

performGlobalAction 执行全局的action动作

通知栏