取得目前全域硬體鍵盤 (key.get_global_keyboard)

該函式在 20260805 以後版本方可使用

聲明

硬體鍵盤物件 = key.get_global_keyboard()

回傳值

• 硬體鍵盤物件 目前已連接的全域硬體鍵盤物件；沒有可用物件時返回 nil。

說明

呼叫 key.get_global_keyboard() 取得由 key.connect_global_keyboard 連接的全域硬體鍵盤物件。

在未連接、正在連接或裝置已經斷開時，本函式均返回 nil。

範例

local keyboard = key.get_global_keyboard()
if keyboard then
    assert(keyboard:press("RETURN"))
end