跳到主要内容

人工辅助

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:XXTouch ImageObject,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 当作永久文件引用。

请求提交、取消或过期后,内联图片不再保留。

API 列表​