跳到主要内容

! 连接全局硬件键盘 (key.connect_global_keyboard)

该函数在 20260805 以后版本方可使用

声明​

硬件键盘对象, 错误信息 = key.connect_global_keyboard([配置属性])

参数​

  • 配置属性 表型，可选参数，与 key.connect_keyboard 使用相同的默认属性和约束。

返回值​

  • 硬件键盘对象 硬件键盘对象，连接成功时返回；连接失败时返回 nil。
  • 错误信息 文本型，连接失败时返回错误信息。

连接失败时，两个返回值合起来为 nil, error。

说明​

创建并连接全局硬件键盘。连接等待期间会隐式让出，在函数返回之前，其他线程可能获得执行机会。

  • 连接后，原有 key.press、key.down、key.up、key.send_text 以及 key(...):press/down/up 的普通键盘和数字小键盘按键会通过该对象输入
  • 媒体键和厂商自定义键仍保持原有行为
  • 没有全局硬件键盘时，原有接口行为不变。
  • key.down 与对应的 key.up 会保持配对，即使两次调用之间连接状态发生变化，也不会造成重复输入或错误释放
  • 同一时间只能连接一个全局硬件键盘。未完成连接时再次调用，或已有全局硬件键盘时再次连接，都会返回失败。

示例​

local keyboard, err = key.connect_global_keyboard({
    Product = "XXTouch Keyboard",
})
assert(keyboard, err)

key.press("A")
key.send_text("Hello")

local current = key.get_global_keyboard()
assert(current == keyboard)

assert(key.disconnect_global_keyboard())