Runtime v2.81 · Cập nhật 30 thg 9, 2026

MatchList

Read-only Class

Một list chỉ đọc gồm các giá trị Match, được trả về từ region.find_any/find_all/find_multi, wait_any/wait_all và Recognition.result khi nhiều mục tiêu nhận diện cùng khớp.

Cú pháp

MatchList

Không thể khởi tạo trực tiếp lớp này.

Tham số

Không có

Giá trị trả về

—

Hành vi / tác động

Thực thi

Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện

Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.

Ví dụ

hits = Region(100, 200, 300, 400).find_all(["hp", "mp"], 5000)
if hits:
    click(hits, offset=(0, 4), random=0)

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Không có

Phương thức

2 phương thức

MatchList.highlight

Method

Vẽ khung highlight cho từng match đã tìm thấy trong list.

Cú pháp

matches.highlight(color="green", line_width=2, region_width=36, auto_hide_ms=0)

Tham số

Tên	Mô tả
`colorColor \| String \| Number`	Màu highlight. Tùy chọn · Theo vị trí hoặc tên Mặc định: `green`
`line_widthNumber`	Độ dày viền tính theo pixel. Tùy chọn · Theo vị trí hoặc tên Mặc định: `2`
`region_widthNumber`	Độ rộng hình vuông dự phòng khi match chỉ có point. Tùy chọn · Theo vị trí hoặc tên Mặc định: `36`
`auto_hide_msNumber`	Thời gian tự ẩn theo mili giây. 0 sẽ giữ highlight hiển thị. Tùy chọn · Theo vị trí hoặc tên Mặc định: `0`

Giá trị trả về

MatchList — Trả về chính match list sau khi vẽ highlight.

Hành vi / tác động

Vẽ khung highlight cho từng match đã tìm thấy trong list. Các phần tử không có point/bounds hợp lệ sẽ bị bỏ qua.

Thực thi

Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện

Ví dụ

hits = Region(100, 200, 300, 400).find_any(["enemy_a", "enemy_b"], 2500)
hits.highlight(color="yellow", line_width=3, auto_hide_ms=1200)

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

MatchList

MatchList.highlight_off

Method

Tắt toàn bộ highlight đang hoạt động được tạo từ match list instance này.

Cú pháp

matches.highlight_off()

Tham số

Không có

Giá trị trả về

MatchList — Trả về chính match list sau khi tắt highlight.

Hành vi / tác động

Tắt toàn bộ highlight đang hoạt động được tạo từ match list instance này.

Thực thi

Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện

Ví dụ

hits = Region(100, 200, 300, 400).find_any(["enemy_a", "enemy_b"], 2500)
hits.highlight()
hits.highlight_off()

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

MatchList