松开硬件键盘按键 (:up)

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

声明

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

参数

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

返回值

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

说明

松开一个之前由 :down 按下的硬件键盘按键。

同一键盘正在执行 :press 或 :send_text 序列时，本方法返回 false, "hardware keyboard is busy"。发送失败时不会自动改用其它输入方式重试。

示例

local keyboard = assert(key.connect_keyboard())

assert(keyboard:down("LEFTSHIFT"))
assert(keyboard:up("LEFTSHIFT"))

assert(keyboard:disconnect())