跳到主要内容

断开硬件键盘 (:disconnect)

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

声明​

是否成功, 错误信息 = 硬件键盘对象:disconnect()

返回值​

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

说明​

释放全部按键并断开该硬件键盘对象。

  • 本方法可以重复调用。
  • 对象是当前全局硬件键盘时，本方法也会清除全局键盘连接。
  • 同一硬件键盘正在执行 :press 或 :send_text 序列时，本方法返回 false, "hardware keyboard is busy"。
  • Lua 回收硬件键盘对象或脚本停止时，XXTouch 同样会自动释放全部按键并断开对象。

示例​

local keyboard = assert(key.connect_keyboard())

local success, err = keyboard:disconnect()
assert(success, err)