这套脚本的全部能力就是下面两张表: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
触摸屏按下 / 松开,坐标配合 ScreenSize
KeyTap 和 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。
常用特殊键
键名
码
键名
码
enter
0x28
escape
0x29
backspace
0x2A
tab
0x2B
spacebar
0x2C
minus
0x2D
equals
0x2E
lbracket
0x2F
rbracket
0x30
backslash
0x31
semicolon
0x33
quote
0x34
tilde
0x35
comma
0x36
period
0x37
slash
0x38
capslock
0x39
appkey
0x65
修饰键
键名
码
说明
lctrl
0xE0
左 Ctrl
lshift
0xE1
左 Shift
lalt
0xE2
左 Alt
lgui
0xE3
左 Win / Command
rctrl
0xE4
右 Ctrl
rshift
0xE5
右 Shift
ralt
0xE6
右 Alt
功能键与编辑键
键名
码
键名
码
f1–f12
0x3A – 0x45
printscreen
0x46
scrolllock
0x47
pause
0x48
insert
0x49
home
0x4A
pageup
0x4B
delete
0x4C
end
0x4D
pagedown
0x4E
right
0x4F
left
0x50
down
0x51
up
0x52
F1–F12 是连续的,f1 = 0x3A 起依次加一。
小键盘
键名
码
键名
码
numlock
0x53
numslash
0x54
numasterisk
0x55
numminus
0x56
numplus
0x57
numenter
0x58
num1–num9
0x59 – 0x61
num0
0x62
numperiod
0x63
六、几个容易记错的地方
equals 是 = 那个键,就是主键盘区 + 的位置(不按 Shift)。想按 + 要 KeyDown("lshift") 配 equals。
tilde 是 ` 那个键(数字 1 左边),不是 ~。
spacebar 不是 space。
appkey 的文档说明写的是「Left Ctrl」,这是文档笔误,码值 0x65 实际是菜单键。不确定就避开不用。
小键盘和主键盘的数字不是同一个键。num5 和 5 在程序看来完全不同——某些软件只认其中一个。