从零到烧录:五步做出第一个宏
-
第一个宏不要做复杂的东西。这篇用最基础的「连点 10 次、每次隔 50 毫秒」走完全流程,五个步骤每一步都能看到结果,走完你就知道这套东西是怎么转的了。
第 0 步:先确认手上有什么
打开 → 关于,记下两个东西:
- 软件版本 / 固件版本——以后所有求助帖都要写这个;
- 设备标识号(右键可复制)。
插上盒子,状态栏第一栏应该是已连接。如果是红的,先解决连接,别往下走。
第 1 步:写
主界面 → 宏编辑。默认三栏,某栏不见了就贴着窗口边缘往外拖。
- 左栏是宏目录,右键可以新建文件夹 / 新建宏 / 重命名;
- 中栏是编辑器,脚本写这里;
- 右栏是函数说明,输入关键字就能查。
先在左栏右键新建一个宏,命名
learn-click10,然后在中间写:-- 连点 10 次,每次间隔 50 毫秒 for i = 1, 10 do MouseClick(1) Delay(50) endMouseClick(1)的1是左键(1 左 / 2 右 / 3 中 / 4 侧后 / 5 侧前),Delay单位是毫秒。这时脚本还不能跑,得先让编译器看一眼。
第 2 步:编译
点工具栏第一个按钮(编译)。
- 下方输出窗口没报错 = 语法通过;
- 报错了会指到行,照着改。常见的是
end少一个、for后面漏了do。
编译只查语法,它不执行任何东西。
第 3 步:在软件里跑一遍
点工具栏第二个按钮(运行Lua脚本)。
鼠标会开始动——注意提前把光标放到安全位置,这一步是真的在点。10 次点完脚本自己结束。
一个必须记住的前提:软件里跑通,不代表硬件里一致。软件侧是把脚本解释执行,硬件侧是编译成字节码后在盒子上跑,速度更快,链路不同。验证阶段的意义是「流程对不对」,手感对不对要烧录后才知道。
第 4 步:绑定
切到 宏绑定 页。三个下拉决定这个宏什么时候响:
下拉 选什么 说明 设备类型 键盘 / 鼠标 选的是插在盒子上的那个设备,不是你手上按的那个 触发按键 键盘可绑全部 HID Usage 键,鼠标支持五键 弹出列表后可以直接敲键盘快速选中 触发类型 按下触发 / 松开触发 / 按下触发松开中断 决定「什么时候开始」和「什么时候停」 左边列表是当前场景(共 10 个场景,可各自配切换快捷键)。点列表左下角添加,选中刚写的
learn-click10加进来,然后配上面三个下拉。这里有一个最容易踩的坑:设备类型必须和实际插的设备一致。插的是鼠标却把快捷键配成键盘组合键,切换不生效——不是坏了,是它压根没收到。
第 5 步:烧录与验证
点宏绑定列表上的第二个按钮(烧录)。这一步把配置写进硬件,之后即使不装软件、不插电脑到原机,盒子插上就能用。
验证:
- 把设备插到盒子上(不要直插电脑);
- 按你绑定的那个键;
- 状态栏第二栏变绿 = 宏在执行,红 = 没跑。
跑起来了,第一个宏就成了。想改参数,回来改脚本 → 编译 → 重新烧录,三步。
五个容易卡住的地方
1. 停不下来。 默认终止键是 ESC。如果你插的是小键盘或鼠标,ESC 可能按不到——去 偏好 → 宏中止按键,配一个手边有的键。这一步建议在第一次烧录前就做。
2. 烧完没反应。 按顺序查:设备类型对不对 → 触发键对不对 → 触发类型对不对 → 场景对不对(10 个场景互相独立,你可能在别的场景里)→ 烧录到底成没成功。
3. 一插设备软件就卡死 / 加载超时。 这是「自动加载宏」把大量宏一次性读进来造成的。处理办法:拔掉设备 → 进偏好把自动加载宏取消勾选 → 插回设备 → 烧录 → 清空所有绑定的宏。恢复后再一项项加回去。
4. 宏执行时按键没反应。 不用慌,这是设计如此:宏按键无冲,宏在跑的时候你仍然可以正常打字,不需要等它结束。
5. 手感忽快忽慢。 单次
Delay误差小于 1ms,但宏的整体节奏还受目标软件响应速度影响。给接收方留出处理时间,比把延时调精确更有效——具体见《延时精度与宏时长预算》。下一步
- 想不写代码也能做宏 → 《图形化块编程入门》,同一份脚本的两种看法,随时切;
- 想搞清这套语言的边界 → 《Lua 语法速查》;
- 想拿现成的改 → 《一键输入常用长文本》和《可控频率连点器》。