請求選擇座標 (LCC.assist.pick_point)

聲明

result, err, task = LCC.assist.pick_point(options)

參數

• options
  表格型，人工輔助請求設定。欄位見 通用參數與傳回物件。本函數會自動設定 type = "point"。

回傳值

• result
  表格型或 nil；成功時包含裝置物理座標 x、y。
• err
  字串型或 nil；失敗時傳回錯誤描述。
• task
  表格型或 nil；最後一次任務狀態。

說明

用於人工能從截圖判斷“點哪裡”，且腳本拿到座標後可以直接按一下的場景。
result.x、result.y 是裝置物理座標，可直接用於 touch.tap(result.x, result.y)。
如果傳的是裁剪圖，需要同時傳 imageRect，中控端會把截圖內座標映射回裝置物理座標。

範例

local result, err = LCC.assist.pick_point({
    title = "選擇確認按鈕",
    text = "請在截圖上點選確認按鈕中心",
    screenshotLocalPath = XXT_SCRIPTS_PATH .. "/screen.png",
    timeout = 180,
})

if result then
    touch.tap(result.x, result.y)
end

裁剪圖範例：

local result, err = LCC.assist.pick_point({
    title = "選擇按鈕",
    text = "請點選裁切圖片裡的確認按鈕",
    screenshotLocalPath = XXT_SCRIPTS_PATH .. "/button-crop.png",
    imageRect = { left = 120, top = 360, width = 300, height = 160 },
})