AIGameAIGame
首页
API文档
UI框架
API实例
UI实例
下载软件
首页
API文档
UI框架
API实例
UI实例
下载软件
  • API文档

    • $global - 全局函数
    • $act - 手势动作
      • 01.手势动作 - $act
      • 02.节点选择器 - UiSelector
    • $ag - 图色框架
    • $app - 应用操作
    • $arc - 悬浮菜单按钮
      • 01.悬浮菜单 - $arc
      • 02.悬浮容器 - MenuBody
      • 03.菜单按钮 - MenuItem
    • $bus - 消息总线
    • $color - 颜色操作
    • $crypt - 加密算法
    • $device - 设备信息
    • $dex - dex,jar,so文件加载
    • $draw - 全局绘制
    • $engine - 脚本引擎
      • 01.任务信息 - JsTaskInfo
      • 02.脚本对象 - $task
    • $fc - 文件选择器
    • $file - 文件操作
    • $floaty - 悬浮窗
    • $img - 图片操作
    • $log - 日志框架
    • $ocr - 文字识别
    • $res - 资源管理器
      • 01.资源管理器 - $res
      • 02.资源操作 - ResManager
    • $root - ROOT与Shell命令
    • $screen - 屏幕操作
    • $storage - 应用内存储
    • $str - 字符串工具类
    • $sys - 系统操作
    • $thread - 并发编程
    • $tip - 对话框
    • $tts - 文字阅读

$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} 启用分辨率适配
最近更新:: 2025/5/14 08:43
Contributors: 孑小白
Prev
$global - 全局函数
Next
$ag - 图色框架