請求人工遠端控制 (LCC.assist.request_control)

聲明

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

參數

• options
  表格型，人工輔助請求設定。欄位見 通用參數與傳回物件。本函數會自動設定 type = "control"。

回傳值

• result
  表格型或 nil；成功時傳回使用者提交的結果。按一下“已完成”會傳回 { kind = "device-control", completed = true }；展開“手動提交結果”提交合法 JSON 時傳回該 JSON 對應的 Lua 表，提交普通文字時傳回 { note = "文字內容" }。
• err
  字串型或 nil；失敗時傳回錯誤描述。
• task
  表格型或 nil；最後一次任務狀態。

說明

用於滑桿、人機驗證、登入、安全驗證、權限彈出視窗、複雜互動等腳本不應繼續猜測的情境。
使用者遠端控制裝置解決問題後按一下“完成”，腳本繼續執行並重新判斷螢幕。
text 中應寫清楚需要使用者完成什麼。

“已完成”和“手動提交結果”是兩個不同入口：

• 按一下“已完成”：適合只表示遠端控制操作已處理完，固定傳回 { kind = "device-control", completed = true }。
• 按一下“手動提交結果”中的“提交”：適合把補充資訊傳回給腳本。合法 JSON 會按結構化結果傳回；非 JSON 文字會作為 { note = "..." } 傳回；空內容不會提交。

範例

local result, err = LCC.assist.request_control({
    title = "人工處理驗證",
    text = "請遠端控制裝置完成驗證後點擊已完成",
    timeout = 300,
})

if not result then
    nLog("遠端控制未完成", err)
end

直接傳目前截圖：

local img = screen.image()

local result, err = LCC.assist.request_control({
    title = "需要人工處理",
    text = "請遠端控制完成目前驗證後點擊完成",
    screenshotImage = img,
    screenshotImageQuality = 0.6,
    timeout = 300,
})

if img.destroy then
    img:destroy()
end