Katalog API Runtime V2

Nilai audio hanya baca untuk mengenali bunyi dalam aplikasi atau game. Gunakan Audio(name) untuk memuat sampel tersimpan, atau Audio.recent(duration_ms) untuk menyalin audio yang baru ditangkap. Penangkapan dan pencocokan berlangsung di perangkat; buffer pendengaran berkelanjutan tidak diunggah dan skrip tidak dapat mengakses audio mentah (PCM).

Mewakili satu warna ARGB dan menyediakan bantuan pengambilan sampel/perbandingan warna.

Buat dan tampilkan panel input runtime untuk parameter makro yang dikontrol skrip.

Gambar teks di atas layar dengan pelacakan interaksi opsional (tekan/pindahkan/tahan). Nama penyetel seperti teks/latar belakang adalah metode; membaca nilai saat ini melalui state().

Sebuah titik di layar, diukur dalam piksel. Pemetaan koordinat kontrol skala/jangkar di seluruh ukuran layar. Setelah pemetaan dan offset, konsumen runtime memasukkan titik akhir ke rentang piksel valid layar saat ini. Titik dapat didestrukturkan menjadi 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.

Parameter pencocokan templat untuk Region. fast_matching memperkecil gambar Region dan templat.

Kontrol statis untuk pengambilan layar bersama selama proses makro saat ini. Cache otomatis biasanya menggunakan kembali frame hingga 100 ms untuk mengurangi beban pengambilan gambar. Untuk pengenalan berulang yang membutuhkan frame terbaru yang tersedia, gunakan auto_cache_off(); ini menambah beban pemrosesan dan penggunaan baterai, tanpa menjamin eksekusi lebih cepat atau piksel yang baru dirender. cache_on() menyematkan frame secara terpisah dan diprioritaskan di atas pengaturan cache otomatis.

Storage key/value persisten untuk makro saat ini. Variabel biasa hanya dibagikan antar-action PYTHON_CODE berurutan dalam flow yang sama, termasuk action di dalam GROUP; flow paralel memiliki variabel terisolasi. Kunci Storage dipakai bersama oleh semua flow, jadi gunakan Storage ketika nilai harus bertahan ke run makro berikutnya, bukan sebagai kanal pesan antarproses. Penulisan disimpan otomatis setelah 2 detik tanpa penulisan baru dan di-commit lagi setelah seluruh Run makro dan semua flow latar berakhir.

Satu titik di dalam jalur gesek datar. Intinya harus berupa Titik atau tupel (x, y). Berikan daftar setidaknya dua nilai SwipePoint untuk menggesek([...]) untuk menggerakkan satu jari melalui beberapa titik.

Akses info sistem/perangkat runtime dan picu tindakan tingkat sistem dari skrip.

Pembungkus gambar templat. Anda dapat menskalakan/memotong templat yang sudah ada, menyimpannya sebagai nama templat baru, atau memeriksa keberadaannya.

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.

Pembantu stopwatch milidetik untuk pemeriksaan waktu skrip dan waktu tunggu yang dijaga.

Pembantu statis untuk tindakan klik/gesek paralel yang dibuat oleh UI atau kode melalui klik(..., paralel=True) dan geser(..., paralel=True). Anda dapat mengumpulkan tindakan klik/gesek dan mengirimkannya bersama-sama, atau memeriksa tindakan klik/gesek yang aktif atau antri. Helper ini juga mendukung pembatalan tindakan klik/gesek aktif (khusus Android 8.0+).

Hasil pencocokan audio hanya-baca. Skor adalah kemiripan, bukan probabilitas ketepatan. Waktu find() memakai linimasa sesi mendengarkan; match() memakai linimasa nilai audio yang dicari. Bandingkan waktu agar satu suara tidak ditangani berulang. Gunakan waktu sebagai deteksi hanya jika matched adalah True.

Kontrol statis untuk memulai flow makro bernama secara paralel. Maksimal dua flow latar dapat berjalan bersama flow utama, dan hanya satu pemanggilan aktif untuk setiap nama flow, termasuk saat dijeda atau dihentikan. Flow.start() segera mengembalikan nilai setelah coordinator menerima cabang; flow latar dapat memulai flow sebaya. Variabel terisolasi per cabang dan tidak pernah digabungkan ke pemanggil. Flow utama menunggu semua flow latar sebelum Run selesai. Nama tidak valid atau duplikat, kapasitas flow penuh, kesalahan cabang apa pun, System.stop(), atau Main Stop mengakhiri seluruh makro. Kontrol dock bernomor untuk setiap flow latar hanya dapat menjeda atau melanjutkan cabang itu sementara; tidak ada Stop per cabang. Pause atau Resume Main berlaku untuk semua cabang, dan Resume global juga menghapus tanda jeda lokal cabang. Gesture sentuh dari cabang berbeda dapat saling membatalkan. Kebijakan ScreenCapture dan audio capture dipakai bersama secara global. Storage memakai kunci persisten yang sama antar-cabang dan bukan kanal pesan antarproses.

Hasil kecocokan pengenalan hanya baca yang dikembalikan oleh pembantu region.find*. Di cabang pengakuan Sukses, Recognition.result menunjuk ke Match atau MatchList yang aktif.

Daftar nilai Kecocokan hanya baca yang ditampilkan berdasarkan region.find_any/find_all/find_multi, wait_any/wait_all, dan Recognition.result ketika beberapa target pengenalan cocok.

Digunakan di cabang pengakuan keberhasilan di UI. Recognition.result mengembalikan Kecocokan untuk satu target pengenalan atau Daftar Kecocokan ketika beberapa target cocok.

Cuplikan satu skrip/item sentuh UI dalam antrean isyarat bersama.

Kumpulan kunci/nilai yang menyimpan urutan penyisipan dan dapat dibaca atau diperbarui selama eksekusi skrip.

Koleksi terurut yang dapat Anda buat, baca, ulangi, ubah strukturnya, dan perbarui saat skrip berjalan.

Kumpulan nilai unik yang bisa berubah. CogniTab menjaga urutan iterasi tetap stabil sehingga keluaran skrip mudah dibaca.

Pengumpulan nilai teks. Dibuat oleh string literal atau str(nilai), kemudian dibaca dengan operasi panjang/indeks/loop.

Koleksi hanya-baca yang dipesan. Gunakan tuple literal ketika nilai harus tetap tetap setelah pembuatan atau ketika mengembalikan nilai yang dikelompokkan untuk destrukturisasi.