! 模拟键入文本 (key.send_text)

本页所述硬件键盘功能在 20260805 以后版本方可使用

声明

key.send_text(文本 [, 每键延迟, Shift 键延迟])

参数

• 文本 文本型，待输入的文字，只能是英文、数字、空格、半角字符以及 "\b"、"\r"、"\t"。
• 每键延迟 整数型，每次按键之间的延迟，单位为毫秒；默认没有延迟，以设备性能极限输入。
• Shift 键延迟 整数型，单位为毫秒；大写字母或某些特殊符号需要按住 Shift 输入，例如 @ 是 Shift + 2。

说明

该函数可用于 sys.input_text 无效时，强制模拟键盘键入。

• 连接全局硬件键盘后，文本会通过该对象输入；没有全局硬件键盘时，仍保持原有行为。
• 硬件键盘根据当前 Lua 的美式键盘映射生成按键和 Shift 组合，最终字符仍受目标系统键盘布局影响。
• 通过硬件键盘输入时，会保护调用前已经按下的按键；发送失败时不会自动改用原有输入方式重试。

示例

key.send_text("AbC12#") -- 尽可能快地键入文本
--
key.send_text("AbC12#", 300) -- 每键入一次延迟 0.3 秒