Hasil kecocokan pengenalan hanya baca yang dikembalikan oleh pembantu region.find*.
Sintaks
MatchKelas ini tidak dapat dibuat langsung.
Parameter
Tidak ada
Nilai yang dikembalikan
—Perilaku / efek samping
Hasil kecocokan pengenalan hanya baca yang dikembalikan oleh pembantu region.find*. Di cabang pengakuan Sukses, Recognition.result menunjuk ke Match atau MatchList yang aktif.
Eksekusi
- Menunggu selesai: Bersyarat
- Keamanan akses bersamaan: Tidak dijamin
- Eksekusi paralel: Bersyarat
Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.
Contoh
m = Region(100, 200, 300, 400).find("btn", 3000)
if m.found:
click(m)
conf = m.confidence
# Recognition.result hanya tersedia di Python pada cabang Berhasil mengenali.
if Recognition.result.found:
click(Recognition.result, random=0)Kesalahan / batasan
Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.
API terkait
Tidak ada
Field
| Nama | Deskripsi |
|---|---|
nameString? | Matched target name. Template matches use the template name without extension, OCR uses the matched target text, and color matches use Color. |
foundBoolean | Whether a match was found. |
confidenceNumber | Confidence score from 0.0 to 1.0. |
confNumber | Alias dari confidence; mengembalikan skor yang sama dari 0.0 hingga 1.0. |
pointPoint? | list[Point] | Titik hasil kecocokan. Pengenalan gambar/OCR/objek biasanya mengembalikan Point; kecocokan gambar di bawah threshold tetap dapat mengembalikan titik kandidat terbaik saat bounds tersedia. Pengenalan warna dan multi-target dapat mengembalikan list[Point] sehingga match.point[0].x/y dapat membaca titik terbaik. |
boundsRegion? | Kotak bounds dari area yang cocok. Kecocokan gambar di bawah threshold tetap dapat menampilkan bounds kandidat terbaik. |
regionRegion? | Alias dari bounds; mengembalikan Region yang sama atau None. |
inference_infodict? | Metadata model atau warna jika tersedia. Metadata TFLite mencakup backend, class_id, class_name, preprocess_ms, inference_ms, postprocess_ms, total_ms, input_width, input_height, dimensi gambar debug opsional, dan telemetri tangkapan layar. Baris debug_result terperinci hanya ditampilkan di dialog debug inference. Metadata warna mencakup backend=color, target_color, sampled_color, point, max_channel_delta, confidence, interval, match_count, dan matches. |
Contoh field
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]
# Di cabang Berhasil mengenali:
current = Recognition.result
if current.found:
text(current.name)
current.highlight(color="yellow", auto_hide_ms=800)