$touch - 触摸驱动#

• 更新时间:2025-12-13 11:58:47

触摸驱动

需要ROOT权限，部分手机不会与手指触摸冲突。

hasPermit()#

是否可用

一般如果有root权限，就是可用的状态，本质上这个函数是用来判断设备是否有root权限的。这个函数性能很高，一旦初始化成功了，就会直接返回true，并不会每次都检查root权限。

• 返回 : {boolean} 是否可用

• 版本 : 1.5.2

//初始化
if($touch.hasPermit()){
    $touch.init();
}
//之后再操作，否则无效果

init()#

初始化

$touch需要初始化才可以使用，初始化大概需要5秒时间，但如果已经初始化过了，就会直接返回true。

• 返回 : {boolean} 是否已经初始化成功

//开始初始化
$touch.init();

touchDown(fingerId, x, y)#

按下手指

• 参数 : fingerId {int} 手指ID

• 参数 : x {int} 坐标X

• 参数 : y {int} 坐标Y

• 版本 : 1.5.2

$touch.touchDown(1, 100, 100);

touchMove(fingerId, x, y)#

移动手指

• 参数 : fingerId {int} 手指ID

• 参数 : x {int} 坐标X

• 参数 : y {int} 坐标Y

• 版本 : 1.5.2

$touch.touchMove(1, 300, 500);

touchUp(fingerId)#

抬起手指

• 参数 : fingerId {int} 手指ID

• 版本 : 1.5.2

$touch.touchUp(1);

click(x, y)#

点击

原理是在C/C++层执行系统命令进行事件注入，因此效率较高

• 参数 : x {int} 坐标X

• 参数 : y {int} 坐标Y

• 版本 : 1.5.4

$touch.click(300, 500);

click(pointerId, x, y)#

点击

默认按压时长为1毫秒，该函数的本质是touchDown和touchUp的组合，因此效率较慢

• 参数 : pointerId {int} 指针ID

• 参数 : x {int} 坐标X

• 参数 : y {int} 坐标Y

• 版本 : 1.5.2

$touch.click(1, 300, 500);

click(pointerId, x, y, dur)#

点击

原理是touchDown和touchUp的组合

• 参数 : pointerId {int} 指针ID

• 参数 : x {int} 坐标X

• 参数 : y {int} 坐标Y

• 参数 : dur {int} 按压时长

• 版本 : 1.5.2

$touch.click(1, 300, 500, 50);

press(x, y)#

长按

原理是touchDown和touchUp的组合，默认按压时间是750毫秒

• 参数 : x {int} 坐标X

• 参数 : y {int} 坐标Y

• 版本 : 1.5.2

$touch.press(300, 500);

press(pointerId, x, y)#

长按

原理是touchDown和touchUp的组合，默认按压时间是750毫秒

• 参数 : pointerId {int} 指针ID

• 参数 : x {int} 坐标X

• 参数 : y {int} 坐标Y

• 版本 : 1.5.2

$touch.press(1, 300, 500);

press(pointerId, x, y, dur)#

长按

原理是touchDown和touchUp的组合

• 参数 : pointerId {int} 指针ID

• 参数 : x {int} 坐标X

• 参数 : y {int} 坐标Y

• 参数 : dur {int} 长按时间

• 版本 : 1.5.2

$touch.press(1, 300, 500, 2000);

move(x, y, x2, y2)#

滑动

默认的滑动时间是1秒

• 参数 : x {int} 起点X

• 参数 : y {int} 起点Y

• 参数 : x2 {int} 终点X

• 参数 : y2 {int} 终点Y

• 版本 : 1.5.2

$touch.move(100, 100, 300, 500);

move(x, y, x2, y2, dur)#

滑动

• 参数 : x {int} 起点X

• 参数 : y {int} 起点Y

• 参数 : x2 {int} 终点X

• 参数 : y2 {int} 终点Y

• 参数 : dur {int} 移动时间

• 版本 : 1.5.2

$touch.move(100, 100, 300, 500, 1000);

move(pointerId, x, y, x2, y2, dur)#

滑动

滑动的时间是根据CPU数量来进行计算的，因此并不一定就完全准确，不同手机执行的滑动时间可能有一点误差，但这并没有太大影响。

• 参数 : pointerId {int} 指针ID

• 参数 : x {int} 起点X

• 参数 : y {int} 起点Y

• 参数 : x2 {int} 终点X

• 参数 : y2 {int} 终点Y

• 参数 : dur {int} 移动时间

• 版本 : 1.5.2

$touch.move(1, 100, 100, 300, 500, 1000);

swipe(x, y, x2, y2, dur)#

模拟滑动

原理是C/C++层系统调用命令来实现注入滑动

• 参数 : x {int} 起点X

• 参数 : y {int} 起点Y

• 参数 : x2 {int} 终点X

• 参数 : y2 {int} 终点Y

• 参数 : dur {int} 滑动时间

• 版本 : 1.5.4

$touch.swipe(100,200,600,1200,2000);

key(keyCode)#

模拟按键

原理是C/C++层系统调用命令来实现注入按键事件

• 参数 : keyCode {int} 键值

• 版本 : 1.5.4

$touch.key(4);//返回按钮