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).

Kumakatawan sa isang kulay ng ARGB at nagbibigay ng color sampling/comparison helper.

Bumuo at magpakita ng runtime input panel para sa mga parameter ng macro na kinokontrol ng script.

Gumuhit ng text sa itaas ng screen na may opsyonal na pagsubaybay sa pakikipag-ugnayan (pindutin/ilipat/i-hold). Ang mga pangalan ng setter tulad ng text/background ay mga pamamaraan; basahin ang mga kasalukuyang halaga sa pamamagitan ng state().

Isang punto sa screen, na sinusukat sa mga pixel. Scale/anchor control coordinate mapping sa mga laki ng screen. Pagkatapos ng pagmamapa at pag-offset, i-clamp ng mga consumer ng runtime ang huling punto sa wastong saklaw ng pixel ng kasalukuyang screen. Point ay maaaring destructured bilang x, y.

A rectangular region on the screen, measured in pixels on the current screen axes. Scale/anchor control coordinate mapping across full-screen sizes without rotating through portrait coordinates or using the app viewport; runtime consumers clip the final region to the current screen after mapping and offsets. ScaleParam controls template matching inside this region. Region can be destructured as x, y, width, height.

Mga parameter ng pagtutugma ng template para sa Region. Pinaliliit ng fast_matching ang larawan ng Region at ang template.

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.

Persistent key/value Storage para sa kasalukuyang macro. Ang normal na variables ay magkakasama lamang sa magkakasunod na PYTHON_CODE action sa iisang flow, kabilang ang action sa GROUP; hiwalay ang variables ng mga parallel flow. Iisa ang mga Storage key sa lahat ng flow, kaya gamitin ito kapag kailangang manatili ang value hanggang sa susunod na macro run, hindi bilang inter-process messaging. Awtomatikong sine-save ang sulat matapos ang 2 segundo na walang bagong sulat at kino-commit muli pagkatapos matapos ang buong macro Run at lahat ng background flow.

Isang punto sa loob ng flat swipe path. Ang punto ay dapat na isang Punto o tuple (x, y). Magpasa ng listahan ng hindi bababa sa dalawang halaga ng SwipePoint upang mag-swipe([...]) upang ilipat ang isang daliri sa maraming puntos.

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

Pambalot ng larawan ng template. Maaari mong sukatin/i-crop ang isang kasalukuyang template, i-save ito bilang isang bagong pangalan ng template, o suriin ang pagkakaroon.

TFLite model handle for scripts. The model type must be selected in Template Manager metadata. Supported outputs are YOLOv8/YOLO11 object detection [1,N,4+C]/[1,4+C,N], YOLO26 end-to-end detection [1,N,6]/[N,6], YOLO11/YOLO26 image classification [1,C], and MobileNetV3 image classification [1,C]. Runtime detects FLOAT32, INT8, or UINT8 tensor precision from the model and dequantizes quantized detection and classification outputs before applying thresholds. Classification matches return class confidence and metadata without point or bounds. Inference methods require a local model file; when local file is missing and runtime download fails, script raises a runtime error.

Millisecond stopwatch helper para sa script timing checks at binabantayang paghihintay.

Static helper for parallel click/swipe actions created by the UI or code via click(..., parallel=True) and swipe(..., parallel=True). You can collect click/swipe actions and send them together, or inspect click/swipe actions that are active or queued. The helper also supports cancelling active click/swipe actions (Android 8.0+ only).

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.

Static na kontrol para magsimula ng mga pinangalanang macro flow nang sabay-sabay. Hanggang dalawang background flow ang maaaring tumakbo kasama ng main flow, at isang live invocation lang para sa bawat pangalan, pati habang naka-pause o humihinto. Agad nagbabalik ang Flow.start() kapag tinanggap ng coordinator ang branch; maaaring magsimula ng peer flow ang background flow. Hiwalay ang variables sa bawat branch at hindi ibinabalik sa tumatawag. Hinihintay ng main flow ang lahat ng background flow bago matapos ang Run. Ang maling o duplicate na pangalan, punô ang background limit, anumang error ng branch, System.stop(), o Main Stop ay magtatapos sa buong macro. Ang bawat may-numérong dock control ay pansamantalang Pause o Resume lang ng sariling branch; walang per-branch Stop. Ang Main Pause o Resume ay para sa lahat, at nililinis din ng global Resume ang local pause flag ng branch. Maaaring magkansela ang touch gesture ng magkakaibang branch. Global na magkakapareho ang ScreenCapture at audio capture policy. Parehong persistent key ang gamit ng Storage sa lahat ng branch at hindi ito inter-process messaging channel.

Read-only recognition match result na ibinalik ng region.find* helpers. Sa isang sangay ng Tagumpay sa pagkilala, itinuturo ng Recognition.result ang aktibong Match o MatchList.

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.

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.

Snapshot ng isang script/UI touch item sa shared gesture queue.

Isang koleksyon ng susi/halaga na nagpapanatili ng pagkakasunud-sunod ng pagpapasok at maaaring basahin o i-update sa panahon ng pagpapatupad ng script.

Isang nakaayos na koleksyon na maaari mong gawin, basahin, i-loop, sirain, at i-update habang tumatakbo ang script.

Isang nababagong koleksyon ng mga natatanging halaga. Pinapanatili ng Cognit Tab na matatag ang pagkakasunud-sunod ng pag-ulit upang madaling basahin ang output ng script.

Pagkolekta ng halaga ng teksto. Ginawa ng string literals o str(value), pagkatapos ay basahin ayon sa haba/index/loop operations.

Isang iniutos na read-only na koleksyon. Gumamit ng mga literal na tuple kapag dapat manatiling maayos ang mga value pagkatapos ng paggawa o kapag nagbabalik ng mga nakagrupong value para sa pagsira.