! 模擬鍵入文字 (key.send_text)

本頁所述硬體鍵盤功能在 20260805 以後版本方可使用

聲明

key.send_text(文字 [, 每鍵延遲, Shift 鍵延遲])

參數

• 文字 文字型，待輸入的文字，只能是英文、數字、空格、半角字元以及 "\b"、"\r"、"\t"。
• 每鍵延遲 整數型，每次按鍵之間的延遲，單位為毫秒；預設沒有延遲，以裝置性能極限輸入。
• Shift 鍵延遲 整數型，單位為毫秒；大寫字母或某些特殊符號需要按住 Shift 輸入，例如 @ 是 Shift + 2。

說明

該函式可用於 sys.input_text 無效時，強制模擬鍵盤鍵入。

• 連接全域硬體鍵盤後，文字會通過該物件輸入；沒有全域硬體鍵盤時，仍保持原有行為。
• 硬體鍵盤根據目前 Lua 的美式鍵盤映射生成按鍵和 Shift 組合，最終字元仍受目標系統鍵盤佈局影響。
• 通過硬體鍵盤輸入時，會保護呼叫前已經按下的按鍵；發送失敗時不會自動改用原有輸入方式重試。

範例

key.send_text("AbC12#") -- 盡可能快地鍵入文本
--
key.send_text("AbC12#", 300) -- 每鍵入一次延遲 0.3 秒