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

ScreenCapture

Mga static na kontrol para sa pinagsasaluhang pagkuha ng screen sa kasalukuyang pagtakbo ng macro.

Syntax

ScreenCapture

Hindi direktang makakagawa ng instance ng class na ito.

Mga parameter

Wala

Ibinabalik na halaga

—

Pagkilos / epekto

Mga static na kontrol para sa pinagsasaluhang pagkuha ng screen sa kasalukuyang pagtakbo ng macro. Karaniwang ginagamit muli ng awtomatikong cache ang mga frame nang hanggang 100 ms upang bawasan ang trabaho sa pagkuha. Para sa madalas na pagkilala na nangangailangan ng pinakabagong available na frame, gamitin ang auto_cache_off(); mas mabigat ito sa pagproseso at baterya at hindi garantisadong mas mabilis o may bagong na-render na mga pixel. Hiwalay na pini-pin ng cache_on() ang isang frame at mas inuuna ito kaysa sa mga setting ng awtomatikong cache.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Sunod-sunod
  • Sabayang pagpapatakbo: May kondisyon

Ina-update ng cache controls ang shared policy nang hindi naghihintay sa frame o itinakdang tagal. Ginagamit ito ng susunod na capture. Nakaaapekto ang pagbabago sa lahat ng flow sa Run; hindi humihingi ng capture permission ang mga kontrol na ito.

Halimbawa

# Gamitin muli ang isang captured frame para sa ilang screen check
ScreenCapture.cache_on()
color = Color.get(Point(500, 900))
hit = Region.full_screen().find("enemy", timeout=0)
ScreenCapture.cache_off()

# Gamitin ang pinakabagong available na frame para sa maikling pagkilala
ScreenCapture.auto_cache_off(duration_ms=1000)
hit = Region.full_screen().find("enemy", timeout=800, rate=30)

# I-off nang walang timer, saka tahasang ibalik ang awtomatikong cache
ScreenCapture.auto_cache_off()
hit = Region.full_screen().find("enemy", timeout=2000, rate=30)
ScreenCapture.auto_cache_on()

Mga error / limitasyon

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

Mga kaugnay na API

Mga method

4 method

ScreenCapture.cache_on

I-pin ang susunod na totoong screen-capture frame at gamitin itong muli hanggang tawagin ang ScreenCapture.cache_off().

Syntax

ScreenCapture.cache_on()

Mga parameter

Wala

Ibinabalik na halaga

None — Walang return value.

Pagkilos / epekto

I-pin ang susunod na totoong screen-capture frame at gamitin itong muli hanggang tawagin ang ScreenCapture.cache_off(). Kung wala pang bagong buffer sa queue, ang pinakabagong valid na frame mula sa kasalukuyang capture reader ang ipi-pin. Hindi ito humihingi ng pahintulot sa pagkuha ng screen.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Sunod-sunod
  • Sabayang pagpapatakbo: May kondisyon

Ina-update ng cache controls ang shared policy nang hindi naghihintay sa frame o itinakdang tagal. Ginagamit ito ng susunod na capture. Nakaaapekto ang pagbabago sa lahat ng flow sa Run; hindi humihingi ng capture permission ang mga kontrol na ito.

Halimbawa

# I-pin ang isang shared frame para sa dalawang recognition pass
ScreenCapture.cache_on()
region = Region(100, 200, 300, 400)
first = region.find("start", 0)
second = region.find("confirm", 0)
ScreenCapture.cache_off()
print(first.found, second.found)

Mga error / limitasyon

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

Mga kaugnay na API

ScreenCapture.cache_off

Alisin ang pagka-pin ng screen-capture frame nang hindi binabago ang mga setting ng awtomatikong cache.

Syntax

ScreenCapture.cache_off()

Mga parameter

Wala

Ibinabalik na halaga

None — Walang return value.

Pagkilos / epekto

Alisin ang pagka-pin ng screen-capture frame nang hindi binabago ang mga setting ng awtomatikong cache. Maaari pa ring gamitin muli ang bagong frame habang naka-on ang awtomatikong cache. Tawagin din ang auto_cache_off() kung kailangan ng pagkilala ang pinakabagong available na frame.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Sunod-sunod
  • Sabayang pagpapatakbo: May kondisyon

Ina-update ng cache controls ang shared policy nang hindi naghihintay sa frame o itinakdang tagal. Ginagamit ito ng susunod na capture. Nakaaapekto ang pagbabago sa lahat ng flow sa Run; hindi humihingi ng capture permission ang mga kontrol na ito.

Halimbawa

# Alisin ang manual na pag-pin bago ang susunod na scan
ScreenCapture.cache_off()
region = Region(100, 200, 300, 400)
print(region.find("start", 0).found)

Mga error / limitasyon

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

Mga kaugnay na API

ScreenCapture.auto_cache_off

I-off ang sinasadyang paggamit muli ng frame sa awtomatikong cache sa loob ng duration_ms millisecond mula sa pagtawag na ito, o hanggang tawagin ang auto_cache_on() o matapos ang macro kung walang argumento o None.

Syntax

ScreenCapture.auto_cache_off(duration_ms=None)

Mga parameter

PangalanPaglalarawan
duration_msNumber | None
Positibong buong bilang ng millisecond (parehong valid ang 100 at 100.0), o None para walang takdang oras sa kasalukuyang pagtakbo ng macro. Tinatanggihan ang zero, negatibo, may bahaging desimal, string, boolean, at mga halagang lampas sa limitasyon.
Opsyonal · Ayon sa posisyon o pangalan
Default: None

Ibinabalik na halaga

None — Walang return value.

Pagkilos / epekto

I-off ang sinasadyang paggamit muli ng frame sa awtomatikong cache sa loob ng duration_ms millisecond mula sa pagtawag na ito, o hanggang tawagin ang auto_cache_on() o matapos ang macro kung walang argumento o None. Pinapalitan ng muling pagtawag ang dating tagal. Saklaw ang pinagsasaluhang bitmap, raw-frame, TFLite, at pixel capture; nilalaktawan ang paggamit muli batay sa TTL, ngunit may takdang oras pa rin ang pagkuha ng frame at hindi nito mapipilit ang Android na mag-render ng mga bagong pixel. Hindi nito inaalis ang pagka-pin mula sa cache_on(), hinihingi ang pahintulot sa screen capture, o hinihintay matapos ang itinakdang tagal.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Sunod-sunod
  • Sabayang pagpapatakbo: May kondisyon

Ina-update ng cache controls ang shared policy nang hindi naghihintay sa frame o itinakdang tagal. Ginagamit ito ng susunod na capture. Nakaaapekto ang pagbabago sa lahat ng flow sa Run; hindi humihingi ng capture permission ang mga kontrol na ito.

Halimbawa

# Pansamantalang lampasan ang automatic cache; hiwalay ang manual na pag-pin
ScreenCapture.cache_off()
ScreenCapture.auto_cache_off(1000)
region = Region(100, 200, 300, 400)
print(region.find("start", 500).found)
ScreenCapture.auto_cache_on()

Mga error / limitasyon

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

Mga kaugnay na API

ScreenCapture.auto_cache_on

Ibalik agad ang normal na awtomatikong frame cache at kanselahin ang pag-off na may timer o walang takdang oras.

Syntax

ScreenCapture.auto_cache_on()

Mga parameter

Wala

Ibinabalik na halaga

None — Walang return value.

Pagkilos / epekto

Ibalik agad ang normal na awtomatikong frame cache at kanselahin ang pag-off na may timer o walang takdang oras. Hindi nito inaalis ang pagka-pin mula sa cache_on(), hinihingi ang pahintulot sa screen capture, o naghihintay. Ibinabalik din ang awtomatikong cache kapag natapos ang macro.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Sunod-sunod
  • Sabayang pagpapatakbo: May kondisyon

Ina-update ng cache controls ang shared policy nang hindi naghihintay sa frame o itinakdang tagal. Ginagamit ito ng susunod na capture. Nakaaapekto ang pagbabago sa lahat ng flow sa Run; hindi humihingi ng capture permission ang mga kontrol na ito.

Halimbawa

# Ibalik ang karaniwang awtomatikong muling paggamit ng frame
ScreenCapture.auto_cache_on()
region = Region(100, 200, 300, 400)
print(region.find("start", 0).found)

Mga error / limitasyon

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

Mga kaugnay na API