建立人工輔助請求 (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