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

Simpan warna, ambil warna layar, atau bandingkan warna. ARGB berisi opasitas (A), merah (R), hijau (G), dan biru (B); compare(), distance_rgb(), dan delta_e() mengabaikan opasitas.

Buat panel untuk meminta pengaturan makro dari pengguna. Tambahkan kolom, lalu panggil show() untuk menampilkannya.

Lacak pergeseran latar antara bingkai layar dengan pencocokan beberapa area OpenCV asli. Ini tidak mendeteksi pemain atau menentukan posisi pada atlas. Kecualikan HUD dan karakter; tangani zoom game di luar pelacak dengan pencocokan template dan skala. Dugaan zoom atau rotasi menghasilkan LOST, bukan perkiraan zoom. Pembuatan tidak menangkap bingkai; maksimal 16 tracker terbuka per flow.

Buat teks di atas aplikasi lain. Panggil show() untuk menampilkan dan menerapkan perubahan berikutnya. Aktifkan pelacakan tekan, seret, atau tahan dengan track(). Baca nilai saat ini lewat state(); text() dan background() adalah metode.

Posisi layar dalam piksel untuk klik, usap, dan penanda. Scale dan anchor menyesuaikan posisi ke ukuran layar lain; posisi akhir dibatasi di dalam layar. Baca kedua koordinat dengan x, y = point.

Area layar berbentuk persegi panjang untuk mencari gambar atau warna, mengambil gambar, atau menggambar bingkai. Koordinat memakai piksel pada sumbu horizontal/vertikal saat ini; setelah penskalaan dan pergeseran, hanya bagian di dalam layar yang digunakan. Baca ukurannya dengan x, y, width, height = region.

Pengaturan pencarian gambar templat di dalam Region. Berikan objek ini sebagai scale_param Region; pengaturan ini tidak mengubah koordinat area.

Atur apakah pengenalan layar memakai ulang gambar tangkapan selama proses makro ini. Biasanya gambar dapat dipakai ulang hingga 100 ms. Panggil metode langsung pada ScreenCapture; jangan buat objeknya.

Simpan nilai bernama untuk digunakan makro ini pada proses berikutnya. Semua alur dalam satu proses berbagi Storage; variabel biasa hanya dibagikan oleh aksi PYTHON_CODE berurutan dalam satu alur, termasuk GROUP. Alur paralel memiliki variabel terpisah. Storage bukan saluran pesan antarproses.

Posisi dan pengaturan gerakan untuk satu langkah usapan. Berikan daftar minimal dua objek SwipePoint ke swipe([...]) untuk menggerakkan satu jari melalui posisi tersebut.

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

Gunakan gambar tersimpan sebagai target pengenalan. Anda dapat mengubah ukuran atau memotongnya menjadi Template terpisah, lalu menyimpan hasilnya dengan save_as().

Gunakan model TFLite yang diimpor di Pengelola Template untuk mengenali objek atau mengklasifikasikan gambar. Pilih jenis model yang benar di sana. Keluaran yang didukung: deteksi YOLOv8/YOLO11 [1,N,4+C]/[1,4+C,N]; deteksi YOLO26 [1,N,6]/[N,6]; klasifikasi YOLO11/YOLO26 dan MobileNetV3 [1,C]. FLOAT32, INT8, dan UINT8 didukung otomatis. Klasifikasi menghasilkan skor dan metadata kelas tanpa titik atau batas layar. Inferensi membutuhkan file model lokal; kegagalan mendapatkannya menyebabkan error.

Ukur waktu yang berlalu dalam milidetik. Jeda dan lanjutkan tanpa kehilangan waktu yang sudah dihitung.

Kelola klik dan usap paralel dari skrip atau aksi makro: kelompokkan, lihat progres, tunggu, atau batalkan. Dalam skrip, gunakan click(..., parallel=True) atau swipe(..., parallel=True). Layanan Aksesibilitas CogniTab harus aktif untuk mengirim gerakan.

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.

Jalankan alur makro bernama secara paralel dan kirim pesan antarnya. Setiap alur memiliki variabel sendiri. Berikan data awal lewat Flow.params; pesan berupa salinan mandiri yang dibaca sesuai urutan pengiriman.

Baca hasil pencarian pengenalan. Periksa found sebelum mengetuk atau memakai lokasinya; pencarian gambar yang gagal masih bisa memuat lokasi kandidat paling mirip.

Baca beberapa hasil pengenalan sebagai daftar Match. Gunakan len(matches), matches[index], atau perulangan for. Daftar yang tidak kosong dapat memuat hasil gagal, terutama setelah wait_any()/wait_all(); periksa found tiap item.

Hasil hanya baca dari MotionTracker.update(). Pergeseran menggambarkan gerak latar antar bingkai, bukan lokasi absolut. Pelacakan tidak mengeklik, mengirim input, mengunggah, atau menyimpan data.

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

Status klik atau usap paralel saat ditanyakan. Diperoleh dari metode Touch; tidak diperbarui otomatis.

Simpan nilai di bawah kunci dan baca berdasarkan kunci. Kunci mempertahankan urutan penambahan; menulis kunci yang sudah ada mengganti nilainya tanpa memindahkan kunci. Setiap kunci memiliki satu nilai.

Simpan item secara berurutan, termasuk nilai berulang. Baca posisi mulai dari 0, ulangi tiap item, atau tambahkan, ganti, dan hapus item pada list yang sama.

Urutan bilangan bulat yang tidak dapat diubah, dibuat dengan range(). Urutan dapat digunakan kembali tanpa membuat seluruh daftar; gunakan list() saat membutuhkan daftar.

Simpan nilai tanpa duplikat dan tambahkan atau hapus nanti. Nilai yang sama hanya muncul sekali: True, 1, dan 1.0 sama. Item harus dapat menjadi kunci dictionary; list, dictionary, set, atau tuple yang memuatnya ditolak. Jangan bergantung pada urutan perulangan.

Simpan teks dalam tanda kutip atau hasil str(value). String tidak dapat diubah langsung; metodenya mengembalikan nilai baru. Posisi dan panjang menghitung titik kode Unicode: satu emoji menempati satu posisi, tetapi huruf dengan aksen terpisah atau emoji gabungan dapat menempati beberapa posisi.

Simpan item berurutan, termasuk duplikat, tanpa dapat menambah, menghapus, atau menggantinya setelah dibuat. List atau dictionary bersarang masih bisa berubah. Dalam kondisi, tuple kosong bernilai false dan tuple berisi bernilai true.