Runtime v2.81 · Na-update noong Set 30, 2026

MatchList

Read-only Class

Isang read-only na listahan ng mga halaga ng Pagtutugma na ibinalik ng region.find_any/find_all/find_multi, wait_any/wait_all, at Recognition.result kapag nagtugma ang maraming target sa pagkilala.

Syntax

MatchList

Hindi direktang makakagawa ng instance ng class na ito.

Mga parameter

Wala

Ibinabalik na halaga

—

Pagkilos / epekto

Isang read-only na listahan ng mga halaga ng Pagtutugma na ibinalik ng region.find_any/find_all/find_multi, wait_any/wait_all, at Recognition.result kapag nagtugma ang maraming target sa pagkilala.

Pagpapatakbo

Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Hindi garantisado
Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Wala

Mga method

2 method

MatchList.highlight

Method

Gumuhit ng mga highlight na frame para sa bawat natagpuang tugma sa listahang ito.

Syntax

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

Mga parameter

Pangalan	Paglalarawan
`colorColor \| String \| Number`	Highlight color. Opsyonal · Ayon sa posisyon o pangalan Default: `green`
`line_widthNumber`	Outline width in pixels. Opsyonal · Ayon sa posisyon o pangalan Default: `2`
`region_widthNumber`	Fallback square width when a match has point only. Opsyonal · Ayon sa posisyon o pangalan Default: `36`
`auto_hide_msNumber`	Auto-hide timeout in milliseconds. 0 keeps highlight visible. Opsyonal · Ayon sa posisyon o pangalan Default: `0`

Ibinabalik na halaga

MatchList — Ibinabalik ang parehong listahan ng tugma pagkatapos ng pagguhit ng mga highlight.

Pagkilos / epekto

Gumuhit ng mga highlight na frame para sa bawat natagpuang tugma sa listahang ito. Nilaktawan ang mga item na walang wastong punto ng pagtutugma/mga hangganan.

Pagpapatakbo

Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Hindi garantisado
Sabayang pagpapatakbo: May kondisyon

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

MatchList

MatchList.highlight_off

Method

I-off ang lahat ng aktibong highlight na nabuo mula sa instance ng listahan ng tugma na ito.

Syntax

matches.highlight_off()

Mga parameter

Wala

Ibinabalik na halaga

MatchList — Ibinabalik ang parehong listahan ng tugma pagkatapos i-off ang highlight.

Pagkilos / epekto

I-off ang lahat ng aktibong highlight na nabuo mula sa instance ng listahan ng tugma na ito.

Pagpapatakbo

Naghihintay matapos: May kondisyon
Kaligtasan ng sabayang paggamit: Hindi garantisado
Sabayang pagpapatakbo: May kondisyon

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

MatchList