请求人工远控 (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