跳到主要内容

获取坐标处的 UI 元素 (ui_element.text_element_at_position)

该函数在 20260507 以后版本方可使用

声明​

元素, 错误信息 = ui_element.text_element_at_position(横坐标, 纵坐标 [, 进程号或选项 ])

参数​

  • 横坐标, 纵坐标 整数型，屏幕坐标，单位为物理像素。
  • 进程号或选项 可选参数，整数型或表型。整数型表示目标 App 进程号；表型可参考 通用选项说明。

返回值​

  • 元素 表型，坐标处命中的 UI 元素。失败时为 nil。
  • 错误信息 文本型，失败原因。

说明​

该接口适合在已经知道坐标点时反查 UI 元素，例如根据图像识别或 OCR 结果理解附近控件。 它不是坐标点击接口；固定坐标点击请使用 touch.tap。 坐标处为空白或目标界面没有提供可读元素时可能失败。

示例​

local ui_element = require("ui_element")

local item, err = ui_element.text_element_at_position(300, 500, {
    include_hit_state = true,
    max_level = 1,
})

if item then
    nLog(item.text or item.value or "")
else
    sys.toast(err)
end

注：上述代码中使用了非本章函数 nLog、sys.toast