跳至主要內容

人工輔助

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 清單​