内置函数与 HID 键码对照表
-
这套脚本的全部能力就是下面两张表:15 条命令 + 9 个函数。没有别的。想确认某个操作能不能做,先在这两张表里找;找不到就是做不到,网上的教程再花哨也没用。
一、键鼠命令
命令 参数 说明 KeyDown(key, ...)HID Usage 整型或按键名,最多 16 个 按下按键。多个参数表示同时按下,可组成组合键 KeyUp(key, ...)同上 松开按键 KeyTap(key, ...)同上 点击按键 = KeyDown+Delay(20)+KeyUp,参数逐个串行ReleaseAllKeys()无 释放所有键盘按键 MouseDown(button)1 左 / 2 右 / 3 中 / 4 侧后 / 5 侧前 按下鼠标键 MouseUp(button)同上 松开鼠标键 MouseClick(button)同上 点击,按下与松开间隔 20ms MoveMouse(x, y)整型坐标 移到屏幕绝对坐标,配合 ScreenSize使用MoveMouseBy(x, y)整型增量 相对当前位置移动 ScrollMouse(click)-128 ~ 127 滚轮,正数向上、负数向下 TouchScreen(is_touched, x, y)0/1, x, y 触摸屏按下 / 松开,坐标配合 ScreenSizeKeyTap和MouseClick里的 20ms 不是隐藏参数,就是它们内部那条Delay(20):
KeyTap(k)=KeyDown(k)→Delay(20)→KeyUp(k),MouseClick(b)=MouseDown(b)→Delay(20)→MouseUp(b)。
所以想要别的间隔,别去调这两个命令,直接用三段式写,Delay填多少就是多少。
另外KeyTap多个参数是逐个按下-松开,不是同时按下。二、延时与其他
命令 参数 说明 Delay(ms)整型,毫秒 延时,误差小于 1ms Log(arg, ...)任意类型,最多 16 个 首个参数含 %d/%s/%f时按 printf 格式化,否则空格分隔输出ScreenSize(w, h)整型宽高 声明脚本参照分辨率,默认 1920×1080 TypeText(text, mode)字符串; gbk/unicode输入文本,编译期展开为按键序列 三、状态查询与数学
函数 参数 返回 IsKeyDown(key)HID Usage 或键名 该键当前是否按下 IsMouseDown(button)1–5 该鼠标键当前是否按下 IsLockKeyOn(key)"capslock"/"numlock"/"scrolllock"锁定键是否亮着 GetUpTime()无 运行时长(毫秒,64 位)。设备端为开机以来,编辑器里为本次校验以来 math.type(v)任意 "integer"或"float"math.tointeger(v)浮点 恰为整数时转成整数,否则返回 0(不是 nil) math.round(v)整数或浮点 四舍五入, .5远离零取整math.abs(v)整数或浮点 绝对值,保持子类型 math.random(m, n)整型 [m, n]闭区间随机整数四、组合键:两种写法
KeyDown支持多参数,可以一次按下多个键:-- 写法 A:分开按 KeyDown("lctrl") KeyDown("lshift") KeyTap("n") KeyUp("lshift") KeyUp("lctrl") -- 写法 B:一次按下(等价,更短) KeyDown("lctrl", "lshift") KeyTap("n") KeyUp("lctrl", "lshift")两种都行。写法 B 的参数顺序不影响结果,松开时顺序也不影响。但按下的与松开的键必须对得上——按了三个只松两个,剩下的会一直粘着,表现是「Ctrl 卡住了」。脚本末尾加
ReleaseAllKeys()可以兜底。五、HID 键码
键名直接写字符串就可以,不需要记码值。需要写码值的场合(比如用变量传参),用下面这套规律。
字母与数字:连续编码
范围 键码 换算式 字母 a–z 0x04 – 0x1D 0x04 + (字母序号),a=0,z=25数字 1–9 0x1E – 0x26 0x1E + (数字 - 1)数字 0 0x27 — 例:
c= 0x04 + 2 = 0x06 = 6;5= 0x1E + 4 = 0x22;w= 0x04 + 22 = 0x1A = 26。常用特殊键
键名 码 键名 码 enter0x28 escape0x29 backspace0x2A tab0x2B spacebar0x2C minus0x2D equals0x2E lbracket0x2F rbracket0x30 backslash0x31 semicolon0x33 quote0x34 tilde0x35 comma0x36 period0x37 slash0x38 capslock0x39 appkey0x65 修饰键
键名 码 说明 lctrl0xE0 左 Ctrl lshift0xE1 左 Shift lalt0xE2 左 Alt lgui0xE3 左 Win / Command rctrl0xE4 右 Ctrl rshift0xE5 右 Shift ralt0xE6 右 Alt 功能键与编辑键
键名 码 键名 码 f1–f120x3A – 0x45 printscreen0x46 scrolllock0x47 pause0x48 insert0x49 home0x4A pageup0x4B delete0x4C end0x4D pagedown0x4E right0x4F left0x50 down0x51 up0x52 F1–F12 是连续的,
f1= 0x3A 起依次加一。小键盘
键名 码 键名 码 numlock0x53 numslash0x54 numasterisk0x55 numminus0x56 numplus0x57 numenter0x58 num1–num90x59 – 0x61 num00x62 numperiod0x63 六、几个容易记错的地方
equals是=那个键,就是主键盘区+的位置(不按 Shift)。想按+要KeyDown("lshift")配equals。tilde是`那个键(数字 1 左边),不是~。spacebar不是space。appkey的文档说明写的是「Left Ctrl」,这是文档笔误,码值 0x65 实际是菜单键。不确定就避开不用。- 小键盘和主键盘的数字不是同一个键。
num5和5在程序看来完全不同——某些软件只认其中一个。