跳至主要內容

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