跳到主要内容

# 请求选择坐标 (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 },
    })