人工輔助
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 當作永久檔案參照。
請求提交、取消或過期後,內嵌圖片不再保留。