テキストを入力 (sys.input_text)

宣言

sys.input_text(入力するテキスト [, 入力完了後に Return キーを押すかどうか ])

パラメータ

• 入力するテキスト
  文字列型。入力するテキストです。20250625 から対応 "\b" (Backspace キー)
• 入力完了後に Return キーを押すかどうか
  真偽値型。テキスト入力後にキーボードの Enter キー (送信、検索など) を押すかどうかを指定します。デフォルトは false です

説明

フォアグラウンドアプリでテキストを入力できる箇所にテキストを入力します
この関数は、まずテキストをクリップボードに書き込み、ペースト用ショートカットキー (command + v) を呼び出して貼り付けます
この関数を呼び出すと共有クリップボードに影響します。呼び出す前に、クリップボード内の重要なデータをバックアップしてください
システムの共有クリップボードが破損している場合、この関数によるテキスト入力は失敗します。つまり、デバイスでテキストを正常にコピー＆ペーストできない場合、この関数も使用できません
この関数と競合することが確認されているプラグイン：Background Manager
動作しない場合は、key.send_text を参照すると解決できる可能性があります

例

sys.input_text("hello") -- 現在のカーソル位置にあるテキストボックスへ "hello" を入力します
--
sys.input_text("hello", true) -- チャット/検索用の入力欄に "hello" を入力し、Enter キーを押して送信または検索を実行します