リクエストを作成して待機する (LCC.assist.request)

宣言

result, err, task = LCC.assist.request(options)

引数

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

戻り値

• result
  テーブルまたは nil。有人対応による送信が成功すると結果オブジェクトを返します。
• err
  文字列または nil。失敗時は "cancelled"、"expired"、"timeout" などのエラー説明を返します。
• task
  テーブルまたは nil。最後に取得したタスクの状態です。

説明

request() は、まず LCC.assist.create(options) を呼び出してリクエストを作成し、次に LCC.assist.wait(task.id, options.timeout, options.pollIntervalMs) を呼び出して結果が返るまで待機します。
ほとんどのスクリプトでは、リクエストタイプが自動設定される ask_text()、pick_point()、request_control() のいずれかを直接使用することを推奨します。
待機がタイムアウトすると、SDK は今回のリクエストを取り消し、nil, "timeout", task を返します。

例

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

if not result then
    nLog("支援リクエストが完了していません", err, task and task.status)
end