跳到主要内容

按下硬件键盘按键 (:down)

该方法在 20260805 以后版本方可使用

声明​

是否成功, 错误信息 = 硬件键盘对象:down(按键码)
是否成功, 错误信息 = 硬件键盘对象:down(Usage_Page, Usage_ID)

参数​

  • 按键码 文本型，与 key.press 使用同一份按键名称映射。
  • Usage Page 整数型，当前硬件键盘对象只接受 Keyboard/Keypad Usage Page 0x07。
  • Usage ID 整数型，物理按键编号，不是字符编码。

返回值​

  • 是否成功 布尔型，发送成功时返回 true，失败时返回 false。
  • 错误信息 文本型，发送失败时返回错误信息。

说明​

按下一个硬件键盘按键。按下后应调用对应的 :up 释放按键。

  • 同一键盘正在执行 :press 或 :send_text 序列时，本方法返回 false, "hardware keyboard is busy"。
  • 同一时间最多按住 6 个普通按键，修饰键不计入；超过限制时目标系统无法识别具体按键。
  • 发送失败时返回 false 和错误信息，不会自动改用其它输入方式重试。

示例​

local keyboard = assert(key.connect_keyboard())

assert(keyboard:press(0x07, 4))       -- Keyboard A
assert(keyboard:down(0x07, 0xE1))    -- Left Shift
assert(keyboard:up(0x07, 0xE1))

assert(keyboard:disconnect())