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