Kết quả nhận diện dạng chỉ đọc, được trả về từ các hàm region.find*.
Cú pháp
MatchKhô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
Kết quả nhận diện dạng chỉ đọc, được trả về từ các hàm region.find*. Trong nhánh Thành công của nhận diện, Recognition.result trỏ tới Match hoặc MatchList nhận diện hiện tại.
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ụ
m = Region(100, 200, 300, 400).find("btn", 3000)
if m.found:
click(m)
conf = m.confidence
# Recognition.result chỉ có sẵn trong Python của nhánh Thành công nhận diện.
if Recognition.result.found:
click(Recognition.result, 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ó
Thuộc tính
| Tên | Mô tả |
|---|---|
nameString? | Tên mục tiêu đã khớp. Nhận diện template dùng tên template không có đuôi file, OCR dùng chính văn bản mục tiêu đã khớp, còn nhận diện màu dùng Color. |
foundBoolean | Có tìm thấy kết quả khớp hay không. |
confidenceNumber | Điểm độ tin cậy từ 0.0 đến 1.0. |
confNumber | Bí danh của confidence; trả về cùng điểm độ tin cậy từ 0.0 đến 1.0. |
pointPoint? | list[Point] | Điểm của kết quả khớp. Nhận diện ảnh/OCR/object thường trả về Point; match ảnh dưới threshold vẫn có thể trả về point ứng viên tốt nhất khi có bounds. Nhận diện màu và nhận diện nhiều mục có thể trả về list[Point] để match.point[0].x/y đọc được điểm tốt nhất. |
boundsRegion? | Vùng bao (bounding box) của kết quả khớp. Match ảnh dưới threshold vẫn có thể cung cấp bounds ứng viên tốt nhất. |
regionRegion? | Bí danh của bounds; trả về cùng Region đã khớp hoặc None. |
inference_infodict? | Metadata model hoặc màu khi có sẵn. Metadata TFLite gồm backend, class_id, class_name, preprocess_ms, inference_ms, postprocess_ms, total_ms, input_width, input_height, kích thước ảnh debug tùy chọn và telemetry chụp màn hình. Các dòng debug_result chi tiết chỉ hiển thị trong dialog debug inference. Metadata màu gồm backend=color, target_color, sampled_color, point, max_channel_delta, confidence, interval, match_count và matches. |
Ví dụ đọc thuộc tính
m = Region(100, 200, 300, 400).find("btn", 3000)
target_name = m.name
is_found = m.found
score = m.confidence
short_score = m.conf
center = m.point
box = m.bounds
same_box = m.region
info = m.inference_info
info_class_id = info.class_id
info_class_name = info.class_name
color_hit = Region(0, 0, 1080, 1920).find_color("#FFFFFF", tolerance=4)
color_name = color_hit.name
first_color_point = color_hit.point[0]
# Trong nhánh Thành công của nhận diện:
current = Recognition.result
if current.found:
text(current.name)
current.highlight(color="yellow", auto_hide_ms=800)