跳到主要内容

# 创建人工辅助请求 (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