有人支援
LCC.assist は、デバイス側スクリプトから集中管理側へ有人支援を依頼するために使用します。スクリプトにスクリーンショットと説明文を添付し、担当者から結果が送信されるまで待機してから、実行を再開できます。
リクエストタイプ
| タイプ | API | 適した場面 | スクリプトでの一般的な処理 |
|---|---|---|---|
| テキスト入力 | LCC.assist.ask_text() | 確認コード、SMS コード、パスフレーズ、ワンタイムトークン | result.text を現在の入力欄へ入力する |
| 座標選択 | LCC.assist.pick_point() | 画像ボタンや予期しないダイアログのボタンなど、タップ位置を人が判断する必要がある場合 | touch.tap(result.x, result.y) を直接実行する |
| 有人リモート操作 | LCC.assist.request_control() | スライダー、CAPTCHA、ログイン、セキュリティ検証、権限ダイアログなどの不安定なフロー | リモート操作の完了後にスクリーンショットを取り直して判定を続ける |
担当者向けの説明には、具体的に実行できる操作を記述し、「補足情報」のような抽象的な表現は避けてください。「リモート操作で現在の認証を完了してから、完了をクリックしてください」「スクリーンショットの確認コードを入力してください」「確認ボタンの中央を選択してください」のような記述を推奨します。
スクリーンショットの指定方法
支援リクエストには、次の方法で画像を添付できます。
screenshotLocalPath:デバイス上のローカル画像パス。SDK が中控の一時リソースとしてアップロードします。screenshotPath:画像がすでに集中管理サーバーのfilesルートディレクトリにある場合、その相対パスを直接渡します。screenshotImage:XXTouch のImageObjectです。SDK が data URL に変換するため、事前にファイルへ保存する必要はありません。screenshotImageData:PNG/JPEG 画像のバイナリデータです。SDK が data URL に変換します。input.imageSrc:スクリプトがすでにdata:image/...、http(s)://...、/api/...のいずれかの画像アドレスを持っている場合、inputに設定してフロントエンドへそのまま渡して表示できます。
SDK は input.imageSrc を上書きしません。input.imageSrc もパス指定のスクリーンショットも渡されていない場合に限り、SDK は screenshotImage または screenshotImageData を input.imageSrc に変換します。
ライフサイクル
リクエストの状態は pending(待機中)、active(処理中)、submitted(結果送信済み)、cancelled(取り消し済み)、expired(期限切れ)です。人工対応の結果を取得できるのは submitted の場合だけです。
LCC.assist.request() の待機がタイムアウトすると、そのリクエストの取り消しを試みます。スクリプトの正常終了時には、現在のインスタンスの未完了リクエストの取り消しを試みます。中控の再起動後はタスクも結果も保持されないため、後で使う結果は別途保存してください。
中控がデバイスの停止状態を受信すると、そのデバイスの pending / active 状態にある lua-script 補助リクエストを取り消します。この一括取り消しは、ほかのデバイス、ほかのソース、提出済みの結果には影響しません。
自動アップロードされたスクリーンショットは中控の起動時に削除されます。長期保存が必要な画像は自分で管理するリソースパスに別途保存し、自動生成された screenshotPath を永続的なファイル参照として使わないでください。
結果送信、取り消し、期限切れ後は、インライン画像は保持されません。
API 一覧
- 共通引数と戻りオブジェクト
- 有人支援リクエストを作成する
LCC.assist.create() - 有人支援の結果を待機する
LCC.assist.wait() - リクエストを作成して待機する
LCC.assist.request() - テキスト入力を依頼する
LCC.assist.ask_text() - 座標の選択を依頼する
LCC.assist.pick_point() - 有人リモート操作を依頼する
LCC.assist.request_control() - 指定したリクエストを取り消す
LCC.assist.cancel() - 現在のスクリプトのリクエストを取り消す
LCC.assist.cancel_all()