! テキスト入力をシミュレートする (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 秒待機