人工辅助
LCC.assist 用于让设备脚本向中控端发起人工辅助请求。脚本可以附带截图和说明文字,阻塞等待人工提交结果,然后继续执行。
请求类型
| 类型 | API | 适合场景 | 脚本通常怎么处理 |
|---|---|---|---|
| 文本回复 | LCC.assist.ask_text() | 验证码、短信码、口令、一次性令牌 | 将 result.text 输入到当前输入框 |
| 选择坐标 | LCC.assist.pick_point() | 需要人工判断点哪里,例如图形按钮、异常弹窗按钮 | 直接 touch.tap(result.x, result.y) |
| 人工远控 | LCC.assist.request_control() | 滑块、人机验证、登录、安全校验、权限弹窗等不稳定流程 | 等人工远控完成后重新截图继续判断 |
给操作人员看的说明要具体可执行,不要写“补充信息”这类抽象说明。建议写成“请远控完成当前验证后点击完成”“请输入截图里的验证码”“请点选确认按钮中心”。
截图来源
辅助请求可以用多种方式带图:
screenshotLocalPath:设备本地图片路径,SDK 会上传为中控临时资源。screenshotPath:图片已经在中控files根目录下时,直接传相对路径。screenshotImage:XXTouchImageObject,SDK 会转成 data URL,不需要先保存到文件。screenshotImageData:PNG/JPEG 图片二进制数据,SDK 会转成 data URL。input.imageSrc:脚本已经有data:image/...、http(s)://...或/api/...图片地址时,可放在input中透传给前端显示。
input.imageSrc 不会被 SDK 覆盖。未传 input.imageSrc 且未传路径截图时,SDK 才会把 screenshotImage 或 screenshotImageData 转成 input.imageSrc。
生命周期
请求状态包括 pending(待处理)、active(处理中)、submitted(已提交)、cancelled(已取消)和 expired(已过期)。只有 submitted 表示已取得人工结果。
LCC.assist.request() 等待超时后会尝试撤销本次请求。脚本正常退出时会尝试撤销当前实例未完成的请求。中控重启后,任务和结果均不保留;需要长期使用的结果请另行保存。
中控收到设备停止状态时,会撤销同一设备上仍为 pending / active 的 lua-script 辅助请求;其它设备、其它来源及已提交结果不受这一批量撤销影响。
自动上传的截图会在中控启动时清理。需要长期复用的截图请另存到自主管理的资源路径,不要把自动生成的 screenshotPath 当作永久文件引用。
请求提交、取消或过期后,内联图片不再保留。