按键函数

触摸操作

8 个函数

单击

Key.tap(x: integer, y: integer)

点击指定坐标一次；支持 Root 和无障碍模式。

参数2 项
序号名称类型参数说明
1 x 整 点击位置的 X 坐标。
2 y 整 点击位置的 Y 坐标。
返回值无返回值

按下

Key.down(x: integer, y: integer, fingerId: integer)

在指定坐标按下并保持；必须配合移动或弹起使用，脚本停止时会自动释放。支持 Root 和无障碍模式；无障碍模式同时只保持一根手指。

参数3 项
序号名称类型参数说明
1 x 整 按下位置的 X 坐标。
2 y 整 按下位置的 Y 坐标。
3 fingerId 整 手指编号，范围 1～5；默认 1。
返回值无返回值

移动

Key.move(目标横坐标: integer, 目标纵坐标: integer, 手指编号: integer, 移动时间: integer)

把已按下的手指移动到目标坐标，适合持续拖动或控制虚拟摇杆。支持 Root 和无障碍模式；无障碍模式需要 Android 8.0 及以上，且只移动当前保持的手指。

参数4 项
序号名称类型参数说明
1 目标横坐标 整 移动终点的 X 坐标。
2 目标纵坐标 整 移动终点的 Y 坐标。
3 手指编号 整 需要移动的手指编号，范围 1～5；默认 1，快捷值仅为预设。
4 移动时间 整 移动到终点的持续时间，单位毫秒；快捷值仅为预设，可手动填写。
返回值无返回值

弹起

Key.up(fingerId: integer)

弹起指定手指编号，结束对应的按下或移动动作；支持 Root 和无障碍模式。无障碍模式会释放当前保持的手指。

参数1 项
序号名称类型参数说明
1 fingerId 整 手指编号，范围 1～5；默认 1。
返回值无返回值

滑动

Key.swipe(startX: integer, startY: integer, endX: integer, endY: integer, duration: integer)

从起点连续滑动到终点；支持 Root 和无障碍模式。Root 模式的时长不受 60000 毫秒限制；无障碍模式受 Android 单次手势限制，小于 2 毫秒按 2 毫秒执行，超过 60000 毫秒按 60000 毫秒执行。

参数5 项
序号名称类型参数说明
1 startX 整 滑动起点 X 坐标。
2 startY 整 滑动起点 Y 坐标。
3 endX 整 滑动终点 X 坐标。
4 endY 整 滑动终点 Y 坐标。
5 duration 整 滑动持续时间，单位毫秒；默认 500。Root 模式可填写超过 60000 的时长；无障碍模式会限制在 2～60000 毫秒。
返回值无返回值

长按

Key.hold(x: integer, y: integer, duration: integer)

按住指定坐标一段时间后自动弹起；支持 Root 和无障碍模式。

参数3 项
序号名称类型参数说明
1 x 整 长按位置的 X 坐标。
2 y 整 长按位置的 Y 坐标。
3 duration 整 长按持续时间，单位毫秒。
返回值无返回值

弹起全部手指

Key.upAll()

弹起全部手指并清理当前触摸状态；支持 Root 和无障碍模式。

参数无参数
返回值无返回值

复杂手势组合动作

Key.action(actions: string)

执行一条或多条手指轨迹；最外层是手指列表，每条轨迹由多个 [X,Y,耗时] 点组成。支持 Root 和无障碍模式。

参数1 项
序号名称类型参数说明
1 actions 字 手势 JSON 字符串，格式 [[[x,y,time],...],...]。示例：[[[100,200,0],[300,200,500]]] 表示一根手指在 500 毫秒内向右移动。
返回值无返回值