Tùy chọn chung

Mô-đun này khả dụng trong các phiên bản sau 20260507

Một số API ui_element nhận bảng tùy chọn để chỉ định ứng dụng đích, số lượng kết quả, độ sâu phần tử con, kiểm tra tương tác và số bước thao tác.

Tùy chọn truy vấn

local options = {
    pid = app.front_pid(),
    max_level = 2,
    max_elements = 200,
    include_hit_state = true,
}

• pid Số nguyên. Mã định danh tiến trình của ứng dụng đích. Khi bỏ qua, ứng dụng ở nền trước thường được dùng.
• max_level Số nguyên. Độ sâu mở rộng phần tử con. Dùng 1 hoặc 2 để giữ dữ liệu trả về ở mức nhỏ.
• max_elements Số nguyên. Số phần tử cấp cao nhất tối đa cần trả về.
• fallback_children Boolean. Thử đọc phần tử con khi danh sách thông thường rỗng. Giá trị mặc định tùy thuộc vào API.
• include_hit_state Boolean. Bao gồm các trường trạng thái tương tác.
• hit_test Boolean. Bật tra cứu tương tác bằng cách lấy mẫu màn hình. Kịch bản thông thường thường không cần tùy chọn này.
• fallback_hit_test Boolean. Thử tra cứu tương tác bằng cách lấy mẫu màn hình khi danh sách thông thường rỗng.
• hit_test_spacing Số. Khoảng cách lấy mẫu màn hình theo tọa độ logic. Mặc định là 40.

Tùy chọn thao tác

• point Bảng. Điểm tọa độ dùng để cuộn hoặc tra cứu tương tác, ví dụ { x = 200, y = 700 }, tính bằng pixel vật lý.
• x / y Số nguyên. Giống point, nhưng được đặt trực tiếp trong bảng tùy chọn.
• steps Số. Tham số bước cho thao tác cuộn, tăng hoặc giảm. Hiệu quả thực tế phụ thuộc vào điều khiển đích.

Mô tả

list_text_elements() giữ các giá trị mặc định thận trọng cho kịch bản cũ. find(), find_all(), snapshot() và các API thao tác thường phù hợp hơn với kịch bản mới. hit_test có thể trả về các phần tử gần lớp trên cùng hiện tại hơn nhưng tốn nhiều tài nguyên hơn. Chỉ dùng khi truy vấn thông thường không tìm thấy mục tiêu.