CogniTabDokumentasi Script
/
Referensi Runtime V2

Pengantar CogniTab Script Runtime

CogniTab Runtime V2 menyediakan mesin skrip berbasis Python yang mudah digunakan untuk otomasi sentuh, pengenalan gambar, deteksi warna, dan interaksi dengan layar Android.

Runtime v2.8130 September 2026

Contoh mulai cepat

Skrip otomasi yang menggabungkan gestur sentuh, pencocokan template dalam area, dan gestur usap melalui beberapa titik:

Python
# Atur koordinat dan lakukan sentuhan dasar
target = Point(540, 960)
click(target)
wait(400)

# Cari gambar tombol di dalam area layar
search = Region(100, 200, 400, 600)
match = search.find("start_btn", timeout=3000)
if match.found:
    click(match)
    wait(250)
else:
    # Usap ke atas jika elemen belum terlihat
    swipe([SwipePoint(Point(500, 1200), speed="NORMAL"), SwipePoint(Point(500, 400))])

Praktik terbaik: Cari banyak gambar dengan ScreenCapture

Saat mencari beberapa template atau warna pada frame yang sama, pemanggilan find() berulang kali akan mengambil tangkapan layar yang tidak perlu. Gunakan ScreenCapture.cache_on() untuk mempertahankan frame saat ini, lakukan semua pencarian, lalu panggil ScreenCapture.cache_off(). Selalu matikan cache saat membutuhkan pengenalan layar secara real-time:

Python
# 1. Pertahankan frame saat ini untuk mempercepat pencarian banyak gambar
ScreenCapture.cache_on()

area = Region(100, 200, 400, 600)
hit_a = area.find("btn_confirm", timeout=0)
hit_b = area.find("btn_cancel", timeout=0)
hit_c = area.find("icon_close", timeout=0)

# 2. Matikan cache untuk pengenalan layar secara real-time
ScreenCapture.cache_off()

if hit_a.found:
    click(hit_a)
elif hit_b.found:
    click(hit_b)

Sintaks Python dasar untuk skrip

1. Deklarasi variabel

Simpan angka, teks, boolean, dan nilai None dengan sintaks Python standar.

Python
# Penetapan variabel dasar
count = 3
title = "Farm run"
enabled = True
nothing = None

2. Definisi fungsi (def)

Gunakan def dan return untuk menyusun logika yang dapat digunakan kembali. Fungsi dapat dipanggil sebelum atau sesudah pernyataan def dalam skrip yang sama.

Python
def add(a, b):
    return a + b

def cell(index):
    return index // 9, index % 9

result = add(2, 3)
row, col = cell(10)

3. Variabel global dan closure

Gunakan kata kunci global untuk mengubah variabel dari luar fungsi; fungsi bersarang otomatis menangkap cakupan induknya.

Python
counter = 0

def increment():
    global counter
    counter += 1
    return counter

4. Kondisi dan perulangan

Atur alur eksekusi dengan if/elif/else, perulangan while, dan perulangan for menggunakan range.

Python
energy = 3
if energy > 0:
    click(Point(500, 900))

for step in range(3):
    wait(200)

5. Kelas inti bawaan

Berinteraksi dengan layar menggunakan kelas bawaan seperti Point, Region, Template, Touch, Color, dan ScreenCapture.

Python
target = Point(500, 900)
search_area = Region(100, 200, 300, 400)

click(target)
match = search_area.find("enemy", 2500)
if match.found:
    click(match)

6. Comprehension koleksi

Buat list, dictionary, dan set dengan ringkas menggunakan klausa for/if.

Python
numbers = [1, 2, 3, 4, 5]
evens = [x for x in numbers if x % 2 == 0]
squares = {x: x * x for x in numbers}

Jelajahi Katalog API

Jelajahi panduan lengkap untuk kelas, kelas sistem hanya-baca, koleksi, dan fungsi gestur.