跳到主要内容

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