Catalog ng API ng Runtime V2

Read-only na audio value para makilala ang mga tunog sa app o laro. Gamitin ang Audio(name) para mag-load ng naka-save na sample, o Audio.recent(duration_ms) para kopyahin ang kakakuha pa lang na audio. Sa device ginagawa ang capture at pagtutugma; hindi ina-upload ang tuloy-tuloy na listening buffer at hindi naa-access ng script ang raw audio (PCM).

Mag-imbak ng kulay, kumuha ng kulay sa screen, o maghambing ng mga kulay. Ang ARGB ay may opacity (A), pula (R), berde (G), at asul (B); hindi ginagamit ng compare(), distance_rgb(), at delta_e() ang opacity.

Gumawa ng panel para sa mga setting ng macro na ilalagay ng user. Magdagdag ng mga field, saka tawagin ang show() upang ipakita ito.

Subaybayan ang paglipat ng background sa pagitan ng mga screen frame gamit ang native OpenCV na pagtutugma ng maraming bahagi. Hindi nito tinutukoy ang player o lokasyon sa atlas. Ibukod ang HUD at character; pangasiwaan ang zoom ng laro sa labas gamit ang template matching at scale. Kapag pinaghinalaang may zoom o pag-ikot, LOST ang resulta at walang pagtatantiya ng zoom. Hindi kumukuha ng frame ang paggawa; hanggang 16 na tracker ang maaaring bukas sa bawat flow.

Gumawa ng tekstong nakapatong sa ibang app. Tawagin ang show() para ipakita ito at ilapat ang mga susunod na pagbabago. Gamitin ang track() para subaybayan ang pagpindot, pag-drag o paghawak. Basahin ang kasalukuyang halaga sa state(); mga method ang text() at background().

Posisyon sa screen na nasa pixel, para sa pag-click, pag-swipe at pagmarka. Inaangkop ng scale at anchor ang posisyon sa ibang laki ng screen; nililimitahan ang huling posisyon sa loob ng screen. Basahin ang dalawang coordinate gamit ang x, y = point.

Parihabang lugar sa screen para maghanap ng larawan o kulay, kumuha ng larawan, o gumuhit ng balangkas. Pixel ang mga coordinate sa kasalukuyang pahalang/patayong axis; pagkatapos i-scale at ilipat, ang bahaging nasa loob lang ng screen ang ginagamit. Basahin ang sukat gamit ang x, y, width, height = region.

Mga setting para sa paghahanap ng larawan ng template sa loob ng Region. Ipasa ang object na ito bilang scale_param ng Region; hindi nito binabago ang mga coordinate ng lugar.

Kontrolin kung gagamitin muli ng pagkilala sa screen ang mga nakuhang larawan sa kasalukuyang pagtakbo ng macro. Karaniwang magagamit muli ang isang larawan nang hanggang 100 ms. Tawagin ang mga method nang direkta sa ScreenCapture; huwag gumawa ng instance.

Mag-save ng mga halagang may pangalan para magamit ng kasalukuyang macro sa susunod na pagtakbo. Magkasalo sa Storage ang lahat ng flow sa isang pagtakbo; ang karaniwang variable ay pinagsasaluhan lang ng sunod-sunod na PYTHON_CODE action sa iisang flow, kasama ang GROUP. Hiwalay ang variable ng magkakasabay na flow. Hindi daluyan ng mensahe sa pagitan ng mga proseso ang Storage.

Posisyon at mga setting ng galaw para sa isang hakbang ng swipe. Magpasa ng listahan ng hindi bababa sa dalawang SwipePoint sa swipe([...]) upang igalaw ang isang daliri sa mga posisyong iyon.

I-access ang impormasyon ng system/device ng runtime at mag-trigger ng mga pagkilos sa antas ng system mula sa script.

Gamitin ang naka-save na larawan bilang target sa pagkilala. Maaari itong baguhin ang laki o i-crop bilang hiwalay na Template, saka i-save ang resulta gamit ang save_as().

Gamitin ang TFLite model na in-import sa Template Manager para kumilala ng mga bagay o uri ng larawan. Piliin ang tamang uri ng model doon. Sinusuportahang output: YOLOv8/YOLO11 detection [1,N,4+C]/[1,4+C,N]; YOLO26 detection [1,N,6]/[N,6]; YOLO11/YOLO26 at MobileNetV3 classification [1,C]. Awtomatikong suportado ang FLOAT32, INT8 at UINT8. Nagbabalik ang classification ng puntos at metadata ng class nang walang punto o hangganan sa screen. Kailangan ng lokal na model file para tumakbo; error kung hindi makuha ito.

Sukatin ang lumipas na oras sa millisecond. I-pause at ipagpatuloy nang hindi nawawala ang nabilang na oras.

Pamahalaan ang sabay-sabay na click at swipe mula sa script o mga action ng macro: ipangkat, tingnan ang progreso, hintayin o kanselahin. Sa script, gamitin ang click(..., parallel=True) o swipe(..., parallel=True). Kailangang naka-enable ang Accessibility service ng CogniTab upang magpadala ng mga gesture.

Read-only na resulta ng pagtutugma ng audio. Pagkakatulad ang score, hindi posibilidad ng katumpakan. Ginagamit ng find() ang timeline ng session ng pakikinig; ginagamit ng match() ang timeline ng audio value na hinahanapan. Ihambing ang mga oras upang hindi paulit-ulit na maproseso ang iisang tunog. Gamitin lamang ang mga oras bilang pagtuklas kapag True ang matched.

Patakbuhin nang sabay ang mga pinangalanang macro flow at magpadala ng mensahe sa pagitan nila. May sariling variable ang bawat flow. Ipasa ang panimulang data sa Flow.params; hiwalay na kopya ang mga mensahe at binabasa ayon sa pagkakasunod ng pagpapadala.

Basahin ang resulta ng paghahanap. Suriin ang found bago mag-tap o gumamit ng lokasyon; maaari pa ring may lokasyon ng pinakamalapit na kandidato kahit hindi nahanap ang larawan.

Basahin ang maraming resulta bilang listahan ng Match. Gamitin ang len(matches), matches[index], o for loop. Maaaring may hindi nahanap na item kahit hindi walang laman ang listahan, lalo na pagkatapos ng wait_any()/wait_all(); suriin ang found ng bawat item.

Read-only na resulta mula sa MotionTracker.update(). Ang paglipat ay galaw ng background sa pagitan ng mga frame, hindi absolute na lokasyon. Hindi nagki-click, nagpapadala ng input, nag-a-upload, o nagse-save ng data ang tracking.

Ginagamit sa sangay ng tagumpay sa pagkilala sa UI. Ibinabalik ng Recognition.result ang Tugma para sa isang target ng pagkilala o MatchList kapag nagtugma ang maraming target.

Kalagayan ng isang parallel na click o swipe noong kinuha ito. Kunin ito mula sa mga method ng Touch; hindi ito kusang nag-a-update.

Mag-imbak ng mga halaga sa ilalim ng mga key at basahin gamit ang key. Pinananatili ang pagkakasunod ng pagdagdag ng mga key; pinapalitan ng pagsulat sa umiiral na key ang halaga nang hindi inililipat ang key. Isang halaga ang bawat key.

Mag-imbak ng mga item ayon sa pagkakasunod, kahit may magkakaparehong halaga. Basahin ang posisyon simula sa 0, ulitin ang mga item sa loop, o magdagdag, magpalit, at mag-alis sa mismong list.

Hindi nababagong sequence ng mga integer na nilikha gamit ang range(). Maaari itong gamitin muli nang hindi gumagawa ng buong list; gamitin ang list() kapag kailangan ng list.

Mag-imbak ng mga halaga na walang duplikado at magdagdag o mag-alis sa susunod. Isang beses lang lalabas ang magkatumbas na halaga: magkatumbas ang True, 1, at 1.0. Dapat maaaring gamiting key ng dictionary ang mga item; hindi tinatanggap ang list, dictionary, set, o tuple na naglalaman ng mga ito. Huwag umasa sa pagkakasunod ng loop.

Mag-imbak ng tekstong nasa panipi o kinonvert gamit ang str(value). Hindi direktang nababago ang string; nagbabalik ng bagong halaga ang mga method nito. Unicode code point ang binibilang sa posisyon at haba: isang posisyon ang isang emoji, ngunit maaaring ilang posisyon ang titik na may hiwalay na accent o pinagsamang emoji.

Mag-imbak ng magkakasunod na item, kahit may magkakapareho, na hindi na madaragdagan, maaalis, o mapapalitan matapos gawin. Maaari pa ring magbago ang nakapaloob na list o dictionary. Sa kondisyon, false ang walang lamang tuple at true ang tuple na may laman.