斷開全域硬體鍵盤 (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)