<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[内置函数与 HID 键码对照表]]></title><description><![CDATA[<p dir="auto">这套脚本的全部能力就是下面两张表：15 条命令 + 9 个函数。没有别的。想确认某个操作能不能做，先在这两张表里找；找不到就是做不到，网上的教程再花哨也没用。</p>
<h2>一、键鼠命令</h2>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>命令</th>
<th>参数</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>KeyDown(key, ...)</code></td>
<td>HID Usage 整型或按键名，最多 16 个</td>
<td>按下按键。多个参数表示同时按下，可组成组合键</td>
</tr>
<tr>
<td><code>KeyUp(key, ...)</code></td>
<td>同上</td>
<td>松开按键</td>
</tr>
<tr>
<td><code>KeyTap(key, ...)</code></td>
<td>同上</td>
<td>点击按键 = <code>KeyDown</code> + <code>Delay(20)</code> + <code>KeyUp</code>，参数逐个串行</td>
</tr>
<tr>
<td><code>ReleaseAllKeys()</code></td>
<td>无</td>
<td>释放所有键盘按键</td>
</tr>
<tr>
<td><code>MouseDown(button)</code></td>
<td>1 左 / 2 右 / 3 中 / 4 侧后 / 5 侧前</td>
<td>按下鼠标键</td>
</tr>
<tr>
<td><code>MouseUp(button)</code></td>
<td>同上</td>
<td>松开鼠标键</td>
</tr>
<tr>
<td><code>MouseClick(button)</code></td>
<td>同上</td>
<td>点击，按下与松开间隔 20ms</td>
</tr>
<tr>
<td><code>MoveMouse(x, y)</code></td>
<td>整型坐标</td>
<td>移到屏幕绝对坐标，配合 <code>ScreenSize</code> 使用</td>
</tr>
<tr>
<td><code>MoveMouseBy(x, y)</code></td>
<td>整型增量</td>
<td>相对当前位置移动</td>
</tr>
<tr>
<td><code>ScrollMouse(click)</code></td>
<td>-128 ~ 127</td>
<td>滚轮，正数向上、负数向下</td>
</tr>
<tr>
<td><code>TouchScreen(is_touched, x, y)</code></td>
<td>0/1, x, y</td>
<td>触摸屏按下 / 松开，坐标配合 <code>ScreenSize</code></td>
</tr>
</tbody>
</table>
<blockquote>
<p dir="auto"><code>KeyTap</code> 和 <code>MouseClick</code> 里的 20ms 不是隐藏参数，就是它们内部那条 <code>Delay(20)</code>：<br />
<code>KeyTap(k)</code> = <code>KeyDown(k)</code> → <code>Delay(20)</code> → <code>KeyUp(k)</code>，<code>MouseClick(b)</code> = <code>MouseDown(b)</code> → <code>Delay(20)</code> → <code>MouseUp(b)</code>。<br />
所以想要别的间隔，别去调这两个命令，直接用三段式写，<code>Delay</code> 填多少就是多少。<br />
另外 <code>KeyTap</code> 多个参数是<strong>逐个</strong>按下-松开，不是同时按下。</p>
</blockquote>
<h2>二、延时与其他</h2>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>命令</th>
<th>参数</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Delay(ms)</code></td>
<td>整型，毫秒</td>
<td>延时，误差小于 1ms</td>
</tr>
<tr>
<td><code>Log(arg, ...)</code></td>
<td>任意类型，最多 16 个</td>
<td>首个参数含 <code>%d/%s/%f</code> 时按 printf 格式化，否则空格分隔输出</td>
</tr>
<tr>
<td><code>ScreenSize(w, h)</code></td>
<td>整型宽高</td>
<td>声明脚本参照分辨率，默认 1920×1080</td>
</tr>
<tr>
<td><code>TypeText(text, mode)</code></td>
<td>字符串；<code>gbk</code> / <code>unicode</code></td>
<td>输入文本，编译期展开为按键序列</td>
</tr>
</tbody>
</table>
<h2>三、状态查询与数学</h2>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>函数</th>
<th>参数</th>
<th>返回</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>IsKeyDown(key)</code></td>
<td>HID Usage 或键名</td>
<td>该键当前是否按下</td>
</tr>
<tr>
<td><code>IsMouseDown(button)</code></td>
<td>1–5</td>
<td>该鼠标键当前是否按下</td>
</tr>
<tr>
<td><code>IsLockKeyOn(key)</code></td>
<td><code>"capslock"</code> / <code>"numlock"</code> / <code>"scrolllock"</code></td>
<td>锁定键是否亮着</td>
</tr>
<tr>
<td><code>GetUpTime()</code></td>
<td>无</td>
<td>运行时长（毫秒，64 位）。设备端为开机以来，编辑器里为本次校验以来</td>
</tr>
<tr>
<td><code>math.type(v)</code></td>
<td>任意</td>
<td><code>"integer"</code> 或 <code>"float"</code></td>
</tr>
<tr>
<td><code>math.tointeger(v)</code></td>
<td>浮点</td>
<td>恰为整数时转成整数，<strong>否则返回 0</strong>（不是 nil）</td>
</tr>
<tr>
<td><code>math.round(v)</code></td>
<td>整数或浮点</td>
<td>四舍五入，<code>.5</code> 远离零取整</td>
</tr>
<tr>
<td><code>math.abs(v)</code></td>
<td>整数或浮点</td>
<td>绝对值，保持子类型</td>
</tr>
<tr>
<td><code>math.random(m, n)</code></td>
<td>整型</td>
<td><code>[m, n]</code> 闭区间随机整数</td>
</tr>
</tbody>
</table>
<h2>四、组合键：两种写法</h2>
<p dir="auto"><code>KeyDown</code> 支持多参数，可以一次按下多个键：</p>
<pre><code class="language-lua">-- 写法 A：分开按
KeyDown("lctrl")
KeyDown("lshift")
KeyTap("n")
KeyUp("lshift")
KeyUp("lctrl")

-- 写法 B：一次按下（等价，更短）
KeyDown("lctrl", "lshift")
KeyTap("n")
KeyUp("lctrl", "lshift")
</code></pre>
<p dir="auto">两种都行。写法 B 的参数顺序不影响结果，松开时顺序也不影响。但<strong>按下的与松开的键必须对得上</strong>——按了三个只松两个，剩下的会一直粘着，表现是「Ctrl 卡住了」。脚本末尾加 <code>ReleaseAllKeys()</code> 可以兜底。</p>
<h2>五、HID 键码</h2>
<p dir="auto">键名直接写字符串就可以，不需要记码值。需要写码值的场合（比如用变量传参），用下面这套规律。</p>
<h3>字母与数字：连续编码</h3>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>范围</th>
<th>键码</th>
<th>换算式</th>
</tr>
</thead>
<tbody>
<tr>
<td>字母 a–z</td>
<td>0x04 – 0x1D</td>
<td><code>0x04 + (字母序号)</code>，a=0，z=25</td>
</tr>
<tr>
<td>数字 1–9</td>
<td>0x1E – 0x26</td>
<td><code>0x1E + (数字 - 1)</code></td>
</tr>
<tr>
<td>数字 0</td>
<td>0x27</td>
<td>—</td>
</tr>
</tbody>
</table>
<p dir="auto">例：<code>c</code> = 0x04 + 2 = 0x06 = 6；<code>5</code> = 0x1E + 4 = 0x22；<code>w</code> = 0x04 + 22 = 0x1A = 26。</p>
<h3>常用特殊键</h3>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>键名</th>
<th>码</th>
<th>键名</th>
<th>码</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>enter</code></td>
<td>0x28</td>
<td><code>escape</code></td>
<td>0x29</td>
</tr>
<tr>
<td><code>backspace</code></td>
<td>0x2A</td>
<td><code>tab</code></td>
<td>0x2B</td>
</tr>
<tr>
<td><code>spacebar</code></td>
<td>0x2C</td>
<td><code>minus</code></td>
<td>0x2D</td>
</tr>
<tr>
<td><code>equals</code></td>
<td>0x2E</td>
<td><code>lbracket</code></td>
<td>0x2F</td>
</tr>
<tr>
<td><code>rbracket</code></td>
<td>0x30</td>
<td><code>backslash</code></td>
<td>0x31</td>
</tr>
<tr>
<td><code>semicolon</code></td>
<td>0x33</td>
<td><code>quote</code></td>
<td>0x34</td>
</tr>
<tr>
<td><code>tilde</code></td>
<td>0x35</td>
<td><code>comma</code></td>
<td>0x36</td>
</tr>
<tr>
<td><code>period</code></td>
<td>0x37</td>
<td><code>slash</code></td>
<td>0x38</td>
</tr>
<tr>
<td><code>capslock</code></td>
<td>0x39</td>
<td><code>appkey</code></td>
<td>0x65</td>
</tr>
</tbody>
</table>
<h3>修饰键</h3>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>键名</th>
<th>码</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>lctrl</code></td>
<td>0xE0</td>
<td>左 Ctrl</td>
</tr>
<tr>
<td><code>lshift</code></td>
<td>0xE1</td>
<td>左 Shift</td>
</tr>
<tr>
<td><code>lalt</code></td>
<td>0xE2</td>
<td>左 Alt</td>
</tr>
<tr>
<td><code>lgui</code></td>
<td>0xE3</td>
<td>左 Win / Command</td>
</tr>
<tr>
<td><code>rctrl</code></td>
<td>0xE4</td>
<td>右 Ctrl</td>
</tr>
<tr>
<td><code>rshift</code></td>
<td>0xE5</td>
<td>右 Shift</td>
</tr>
<tr>
<td><code>ralt</code></td>
<td>0xE6</td>
<td>右 Alt</td>
</tr>
</tbody>
</table>
<h3>功能键与编辑键</h3>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>键名</th>
<th>码</th>
<th>键名</th>
<th>码</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>f1</code>–<code>f12</code></td>
<td>0x3A – 0x45</td>
<td><code>printscreen</code></td>
<td>0x46</td>
</tr>
<tr>
<td><code>scrolllock</code></td>
<td>0x47</td>
<td><code>pause</code></td>
<td>0x48</td>
</tr>
<tr>
<td><code>insert</code></td>
<td>0x49</td>
<td><code>home</code></td>
<td>0x4A</td>
</tr>
<tr>
<td><code>pageup</code></td>
<td>0x4B</td>
<td><code>delete</code></td>
<td>0x4C</td>
</tr>
<tr>
<td><code>end</code></td>
<td>0x4D</td>
<td><code>pagedown</code></td>
<td>0x4E</td>
</tr>
<tr>
<td><code>right</code></td>
<td>0x4F</td>
<td><code>left</code></td>
<td>0x50</td>
</tr>
<tr>
<td><code>down</code></td>
<td>0x51</td>
<td><code>up</code></td>
<td>0x52</td>
</tr>
</tbody>
</table>
<p dir="auto">F1–F12 是连续的，<code>f1</code> = 0x3A 起依次加一。</p>
<h3>小键盘</h3>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>键名</th>
<th>码</th>
<th>键名</th>
<th>码</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>numlock</code></td>
<td>0x53</td>
<td><code>numslash</code></td>
<td>0x54</td>
</tr>
<tr>
<td><code>numasterisk</code></td>
<td>0x55</td>
<td><code>numminus</code></td>
<td>0x56</td>
</tr>
<tr>
<td><code>numplus</code></td>
<td>0x57</td>
<td><code>numenter</code></td>
<td>0x58</td>
</tr>
<tr>
<td><code>num1</code>–<code>num9</code></td>
<td>0x59 – 0x61</td>
<td><code>num0</code></td>
<td>0x62</td>
</tr>
<tr>
<td><code>numperiod</code></td>
<td>0x63</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<h2>六、几个容易记错的地方</h2>
<ul>
<li><strong><code>equals</code> 是 <code>=</code> 那个键</strong>，就是主键盘区 <code>+</code> 的位置（不按 Shift）。想按 <code>+</code> 要 <code>KeyDown("lshift")</code> 配 <code>equals</code>。</li>
<li><strong><code>tilde</code> 是 <code>`</code> 那个键</strong>（数字 1 左边），不是 <code>~</code>。</li>
<li><strong><code>spacebar</code> 不是 <code>space</code></strong>。</li>
<li><strong><code>appkey</code> 的文档说明写的是「Left Ctrl」</strong>，这是文档笔误，码值 0x65 实际是菜单键。不确定就避开不用。</li>
<li><strong>小键盘和主键盘的数字不是同一个键</strong>。<code>num5</code> 和 <code>5</code> 在程序看来完全不同——某些软件只认其中一个。</li>
</ul>
]]></description><link>https://www.byteohm.com/topic/61/内置函数与-hid-键码对照表</link><generator>RSS for Node</generator><lastBuildDate>Thu, 19 Nov 2026 05:42:20 GMT</lastBuildDate><atom:link href="https://www.byteohm.com/topic/61.rss" rel="self" type="application/rss+xml"/><pubDate>Thu, 05 Nov 2026 16:46:10 GMT</pubDate><ttl>60</ttl></channel></rss>