CogniTabDokumentasyon ng Script
/
Sanggunian ng Runtime V2

Panimula sa CogniTab Script Runtime

Nagbibigay ang CogniTab Runtime V2 ng madaling gamiting scripting engine na batay sa Python para sa touch automation, pagkilala ng larawan, pagtukoy ng kulay, at pakikipag-ugnayan sa Android screen.

Runtime v2.81Setyembre 30, 2026

Mabilisang halimbawa

Pinagsasama ng automation script na ito ang mga touch gesture, paghahanap ng template sa isang rehiyon, at pag-swipe sa maraming punto:

Python
# Itakda ang mga coordinate at magsagawa ng simpleng touch
target = Point(540, 960)
click(target)
wait(400)

# Hanapin ang larawan ng button sa loob ng isang rehiyon
search = Region(100, 200, 400, 600)
match = search.find("start_btn", timeout=3000)
if match.found:
    click(match)
    wait(250)
else:
    # Mag-swipe pataas kung hindi pa nakikita ang elemento
    swipe([SwipePoint(Point(500, 1200), speed="NORMAL"), SwipePoint(Point(500, 400))])

Pinakamainam na paraan: Maghanap ng maraming larawan gamit ang ScreenCapture

Kapag maraming template o kulay ang hahanapin sa iisang frame, paulit-ulit na kumukuha ng screen capture ang bawat tawag sa find(). Gamitin ang ScreenCapture.cache_on() para panatilihin ang kasalukuyang frame, gawin ang lahat ng paghahanap, at tawagin ang ScreenCapture.cache_off() pagkatapos. Tandaang patayin ang cache kapag kailangan ang real-time na pagkilala sa screen:

Python
# 1. Panatilihin ang kasalukuyang frame para mapabilis ang paghahanap ng maraming larawan
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. Patayin ang cache kapag kailangan ang real-time na pagkilala sa screen
ScreenCapture.cache_off()

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

Pangunahing Python syntax para sa mga script

1. Pagdedeklara ng variable

Mag-imbak ng mga numero, text, boolean, at None value gamit ang karaniwang Python syntax.

Python
# Pagtatalaga ng pangunahing variable
count = 3
title = "Farm run"
enabled = True
nothing = None

2. Pagde-define ng function (def)

Gamitin ang def at return para ayusin ang lohikang maaaring gamitin muli. Maaaring tawagin ang mga function bago o pagkatapos ng def statement sa iisang script.

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. Mga global variable at closure

Gamitin ang global keyword para baguhin ang mga variable sa labas ng function; awtomatikong nakakakuha ng scope ng parent ang mga nested function.

Python
counter = 0

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

4. Mga kondisyon at loop

Kontrolin ang daloy ng execution gamit ang if/elif/else, while loop, at for loop na may range.

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

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

5. Mga pangunahing built-in na class

Makipag-ugnayan sa screen gamit ang mga nakahandang class gaya ng Point, Region, Template, Touch, Color, at 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. Mga comprehension para sa collection

Gumawa nang maigsi ng list, dictionary, at set gamit ang mga for/if clause.

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}

Tuklasin ang API Catalog

Tingnan ang buong sanggunian para sa mga class, read-only na system class, collection, at gesture function.