#$hid - 键鼠触控

• 更新时间:2026-02-08 19:43:40

键鼠触控

无需任何权限，连接键鼠硬件即可完成自动化触控功能。

#init()

初始化HID

• 返回 : {String} 初始化成功返回true，否则就是失败原因
• 版本 : 1.8.9

let res = $hid.init();
if(res=="true"){
    log("初始化成功");
}else{
    log("初始化失败:",res);
}

#isOn()

判断是否开启

判断是否链接了硬件

• 返回 : {boolean} 是否开启
• 版本 : 1.8.9

if($hid.isOn()){
    log("处于开启状态");
}

#dexBeat()

获取版本号

获取插件版本号

• 返回 : {float} 版本号
• 版本 : 1.8.9

log("HID版本:",$hid.dexBeat());

#getBatteryLevel()

获取电量

获取手机当前电量

• 返回 : {int} 电量
• 版本 : 1.8.9

log("电池电量:",$hid.getBatteryLevel());

#isCharging()

是否处于充电状态

判断当前手机是否在供电

• 返回 : {boolean} 是否处于充电状态
• 版本 : 1.8.9

if($hid.isCharging()){
    log("正在充电...");
}

#setPowerOff()

关闭供电

• 版本 : 1.8.9

$hid.setPowerOff();

#setPowerOn()

开启供电

• 版本 : 1.8.9

$hid.setPowerOn();

#click(x, y)

点击

• 参数 : x {int} 坐标x
• 参数 : y {int} 坐标y
• 返回 : {boolean} 是否点击成功
• 版本 : 1.8.9

$hid.click(100,100);

#click(index)

点击

• 参数 : index {int[]} 坐标
• 返回 : {boolean} 是否点击成功
• 版本 : 1.8.9

$hid.click([100,100]);

#longClick(x, y, dur)

长按

• 参数 : x {int} 坐标x
• 参数 : y {int} 坐标y
• 参数 : dur {int} 长按时间
• 返回 : {boolean} 是否点击成功
• 版本 : 1.8.9

$hid.longClick(100,100,1500);

#longClick(index)

长按

• 参数 : index {int[]} 坐标
• 返回 : {boolean} 是否点击成功
• 版本 : 1.8.9

$hid.longClick([100,100,1500]);

#swipEx(x1, y1, x2, y2)

增强滑动

• 参数 : x1 {int} 起点坐标x
• 参数 : y1 {int} 起点坐标y
• 参数 : x2 {int} 终点坐标x
• 参数 : y2 {int} 终点坐标y
• 返回 : {boolean} 是否滑动成功
• 版本 : 1.8.9

$hid.swipEx(100,100,200,200);

#swipEx(x1, y1, x2, y2, press, time, delay)

增强滑动

• 参数 : x1 {int} 起点坐标x
• 参数 : y1 {int} 起点坐标y
• 参数 : x2 {int} 终点坐标x
• 参数 : y2 {int} 终点坐标y
• 参数 : press {int} 按下时长(默认:300)
• 参数 : time {int} 滑动时长(默认:1000)
• 参数 : delay {int} 延迟时长(默认:0)
• 返回 : {boolean} 是否滑动成功
• 版本 : 1.8.9

$hid.swipEx(100,100,200,200,300,1000,0);

#touchDown(id, x, y)

按下

• 参数 : id {int} 手指id
• 参数 : x {int} 坐标x
• 参数 : y {int} 坐标y
• 返回 : {boolean} 是否按下成功
• 版本 : 1.8.9

$hid.touchDown(0,100,100);

#touchMove(id, x, y)

移动

• 参数 : id {int} 手指id
• 参数 : x {int} 坐标x
• 参数 : y {int} 坐标y
• 返回 : {boolean} 是否移动成功
• 版本 : 1.8.9

$hid.touchMove(0,100,100);

#touchUp(id)

抬起

• 参数 : id {int} 手指id
• 返回 : {boolean} 是否抬起成功
• 版本 : 1.8.9

$hid.touchUp(0);

#keyPress(keyCode)

按键

• 参数 : keyCode {int} 按键码
• 返回 : {boolean} 是否按下成功
• 版本 : 1.8.9

$hid.keyPress(40);

#keyPress(modify, keyCode)

按键

• 参数 : modify {int} 组合按键码
• 参数 : keyCode {int} 按键码
• 返回 : {boolean} 是否按下成功
• 版本 : 1.8.9

$hid.keyPress(0,40);

#home()

主页

按下手机主页键

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.home();

#back()

返回

按下手机返回键

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.back();

#recents()

最近

按下手机后台键

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.recents();

#recentsV2()

最近任务增强版

按下手机后台键 第二种方法,特殊机型使用

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.recentsV2();

#selectAll()

全选

按下手机全选键 选择输入框 全部文本内容

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.selectAll();

#cut()

剪切

按下手机剪切键 剪切输入框 全部文本内容到剪切板

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.cut();

#copy()

复制

按下手机后台键 复制输入框 全部文本内容到剪切板

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.copy();

#paste()

粘贴

按下手机粘贴键 剪切板内容粘贴到输入框内 可以配合写入剪切板命令

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

//先设置剪切板
$sys.setClip("我是来自剪切板的内容");
//再粘贴内容
$hid.paste();

#paste(text)

粘贴文本

按下手机粘贴键 剪切板内容粘贴到输入框内 可以配合写入剪切板命令

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.paste("我是来自剪切板内容");
//等价于下面的写法
//1.先设置剪切板
$sys.setClip("我是来自剪切板的内容");
//2.再粘贴内容
$hid.paste();

#inputSimple(text)

输入

按下手机键盘键 在输入框输入英文字母+数字

注意:标点符号和中文不能输入

• 参数 : text {String} 文本
• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.inputSimple("abcd1234");

#delete()

删除

按下手机删除键 删除输入框文本内容 特殊机型用回退键

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.delete();

#delete(len)

删除

按下手机删除键 删除输入框文本内容 特殊机型用回退键

• 参数 : len {int} 删除长度
• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.delete(2);

#backspace()

回退

按下手机回退键 回退输入框文本内容 特殊机型用回退键

• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.backspace();

#backspace(len)

回退

按下手机回退键 回退输入框文本内容 特殊机型用回退键

• 参数 : len {int} 回退长度
• 返回 : {boolean} 是否成功
• 版本 : 1.8.9

$hid.backspace(2);