跳至主要內容

取得座標處的 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