有人支援リクエストを作成する (LCC.assist.create)

宣言

task, err = LCC.assist.create(options)

引数

• options
  テーブル。有人支援リクエストの設定です。フィールドについては、共通引数と戻りオブジェクトを参照してください。

戻り値

• task
  テーブルまたは nil。作成に成功すると、集中管理側のタスクオブジェクトを返します。
• err
  文字列または nil。失敗時はエラーの説明を返します。

説明

タスクを作成するだけで、有人対応の結果は待ちません。
screenshotLocalPath を渡した場合は、デバイス上のスクリーンショットをアップロードしてからタスクを作成します。
screenshotImage または screenshotImageData を渡した場合、SDK が data URL に変換してリクエストとともに送信するため、事前にファイルへ保存する必要はありません。
作成に成功すると、タスクは現在のスクリプトの未完了リクエスト集合へ記録され、後から cancel_all() でクリーンアップできます。
スクリプトが作成したタスクには、deviceId = device.udid() と source = "lua-script" が自動的に書き込まれます。

例

local task, err = LCC.assist.create({
    type = "control",
    title = "有人による確認",
    text = "リモート操作で現在の確認を完了してから「完了」をクリックしてください",
    timeout = 300,
})

if not task then
    nLog("支援リクエストの作成に失敗しました", err)
    return
end

local result, waitErr = LCC.assist.wait(task.id, 300, 1000)
if not result then
    nLog("支援リクエストが完了していません", waitErr)
end