Chuyển tới nội dung chính

Lấy phần tử giao diện tại một vị trí (ui_element.text_element_at_position)

Hàm này khả dụng trong các phiên bản sau 20260507

Khai báo​

phần tử, thông báo lỗi = ui_element.text_element_at_position(tọa độ x, tọa độ y [, mã tiến trình hoặc tùy chọn ])

Tham số​

  • tọa độ x, tọa độ y
    Số nguyên. Tọa độ màn hình tính bằng pixel vật lý.
  • mã tiến trình hoặc tùy chọn
    Không bắt buộc, số nguyên hoặc bảng. Số nguyên là mã định danh tiến trình của ứng dụng đích; các tùy chọn bảng được mô tả trong Tùy chọn chung.

Giá trị trả về​

  • phần tử
    Bảng. Phần tử giao diện tại tọa độ. nil khi thất bại.
  • thông báo lỗi
    Chuỗi. Lý do thất bại.

Mô tả​

Dùng API này khi đã biết một điểm và muốn đọc phần tử giao diện tại đó, chẳng hạn sau khi nhận dạng hình ảnh hoặc OCR. Đây không phải API nhấn theo tọa độ. Với thao tác nhấn theo tọa độ cố định, hãy dùng touch.tap. API có thể thất bại khi điểm đó trống hoặc màn hình đích không cung cấp phần tử có thể đọc tại đó.

Ví dụ​

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

Lưu ý: Ví dụ dùng các API ngoài chương này là nLog và sys.toast.