断开全局硬件键盘 (key.disconnect_global_keyboard)

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

声明

是否成功, 错误信息 = key.disconnect_global_keyboard()

返回值

• 是否成功 布尔型，断开成功或当前没有全局硬件键盘时返回 true；失败时返回 false。
• 错误信息 文本型，断开失败时返回错误信息。

说明

释放全部按键并断开当前全局硬件键盘。断开后，原有按键接口恢复连接前的行为。

• 本函数可以重复调用；当前没有全局硬件键盘时也返回成功。
• 全局硬件键盘正在执行 :press 或 :send_text 序列时，断开会返回 false, "hardware keyboard is busy"。
• 已经由 key.down 按下的按键会在断开时释放；之后对应的 key.up 不会再次发送输入。

示例

local success, err = key.disconnect_global_keyboard()
assert(success, err)