แค็ตตาล็อก API ของ Runtime V2
65 หัวข้อรายการคลาส คอลเลกชัน และฟังก์ชันอัตโนมัติในตัวทั้งหมดที่ใช้ได้ใน CogniTab Script Runtime
📦 คลาส
16 หัวข้อ- →
AudioClassAudio(name)ค่าเสียงแบบอ่านอย่างเดียวสำหรับตรวจจับเสียงในแอปหรือเกม ใช้ Audio(name) เพื่อโหลดตัวอย่างที่บันทึกไว้ หรือ Audio.recent(duration_ms) เพื่อคัดลอกเสียงที่เพิ่งจับมา การจับและจับคู่เสียงทำบนอุปกรณ์ โดยไม่อัปโหลดบัฟเฟอร์การฟังต่อเนื่องและไม่ให้สคริปต์เข้าถึงข้อมูลเสียงดิบ (PCM)
- →
ColorClassColor(value, /)เก็บสี อ่านสีจากหน้าจอ หรือเปรียบเทียบสี ARGB ประกอบด้วยความทึบ (A), แดง (R), เขียว (G) และน้ำเงิน (B); compare(), distance_rgb() และ delta_e() ไม่ใช้ค่าความทึบ
- →
MacroPanelClassMacroPanel(title="", subtitle="", confirm_text="Run", cancel_text="Cancel", *, version="")สร้างแผงให้ผู้ใช้กรอกการตั้งค่ามาโคร เพิ่มช่องกรอกแล้วเรียก show() เพื่อแสดงแผง
- →
MotionTrackerClassMotionTracker(region=None, exclude=None, max_displacement=80, max_gap_ms=850, max_frame_age_ms=250)ติดตามการเลื่อนของพื้นหลังระหว่างเฟรมหน้าจอด้วย OpenCV แบบหลายบริเวณ ไม่ตรวจจับผู้เล่นหรือหาตำแหน่งบนแผนที่ ให้ยกเว้น HUD และตัวละคร และจัดการซูมเกมภายนอกด้วยการจับคู่เทมเพลตและสเกล หากสงสัยว่ามีการซูมหรือหมุนจะได้ LOST ไม่ใช่ค่าประมาณซูม การสร้างไม่จับภาพ และแต่ละ flow เปิด tracker ได้ไม่เกิน 16 ตัว.
- →
OverlayTextClassOverlayText(text="", position=(0, 0), color="#FFFFFFFF", size=16, background=None)สร้างข้อความลอยเหนือแอปอื่น เรียก show() เพื่อแสดงและใช้การเปลี่ยนแปลงภายหลัง ใช้ track() เพื่อติดตามการกด ลาก หรือกดค้าง อ่านค่าปัจจุบันด้วย state(); text() และ background() เป็นเมธอด
- →
PointClassPoint(x, y, /, scale="fixed", anchor="none")ตำแหน่งบนหน้าจอในหน่วยพิกเซล ใช้สำหรับคลิก ปัด และทำเครื่องหมาย Scale และ anchor ปรับตำแหน่งตามขนาดหน้าจอ โดยจำกัดตำแหน่งสุดท้ายให้อยู่ในหน้าจอ อ่านพิกัดทั้งสองด้วย x, y = point
- →
RegionClassRegion(x, y, width, height, /, scale="fixed", anchor="none", scale_param=ScaleParam())พื้นที่สี่เหลี่ยมบนหน้าจอสำหรับค้นหาภาพหรือสี จับภาพ หรือวาดกรอบ พิกัดเป็นพิกเซลตามแกนนอนและแนวตั้งปัจจุบัน หลังปรับขนาดและระยะเลื่อนจะใช้เฉพาะส่วนที่อยู่ในหน้าจอ อ่านขนาดด้วย x, y, width, height = region
- →
ScaleParamClassScaleParam(grayscale=True, auto_scale=False, cache_scale=True, template_scale="SHORT_EDGE", fast_matching=False)การตั้งค่าสำหรับค้นหาภาพแม่แบบภายใน Region ส่งออบเจ็กต์นี้เป็น scale_param ของ Region การตั้งค่าเหล่านี้ไม่เปลี่ยนพิกัดของพื้นที่
- →
ScreenCaptureClassScreenCaptureควบคุมการใช้ภาพจับหน้าจอซ้ำในการตรวจจับระหว่างการรันมาโครปัจจุบัน โดยปกติใช้ภาพซ้ำได้นานถึง 100 ms เรียกเมธอดผ่าน ScreenCapture โดยตรง ไม่ต้องสร้างออบเจ็กต์
- →
StorageClassStorageบันทึกค่าตามชื่อให้มาโครปัจจุบันใช้ในการรันครั้งต่อไป ทุกโฟลว์ในการรันเดียวกันใช้ Storage ร่วมกัน ตัวแปรปกติใช้ร่วมเฉพาะแอ็กชัน PYTHON_CODE ที่ทำตามลำดับในโฟลว์เดียว รวมถึงใน GROUP โฟลว์ขนานมีตัวแปรแยกกัน Storage ไม่ใช่ช่องส่งข้อความระหว่างโปรเซส
- →
SwipePointClassSwipePoint(point, speed="NORMAL", delay_before=0, random=10, humanized=False, scale="fixed", anchor="none")ตำแหน่งและการตั้งค่าการเคลื่อนที่สำหรับหนึ่งขั้นของการปัด ส่งรายการ SwipePoint อย่างน้อยสองรายการให้ swipe([...]) เพื่อเลื่อนนิ้วหนึ่งนิ้วผ่านตำแหน่งเหล่านั้น
- →
SystemClassSystem()เข้าถึงข้อมูลระบบ/อุปกรณ์รันไทม์และทริกเกอร์การดำเนินการระดับระบบจากสคริปต์
- →
TemplateClassTemplate(name, /)ใช้ภาพที่บันทึกไว้เป็นเป้าหมายการจดจำ คุณย่อขยายหรือตัดภาพเป็น Template แยกต่างหาก แล้วบันทึกผลด้วย save_as() ได้
- →
TfliteModelClassTfliteModel(model)ใช้โมเดล TFLite ที่นำเข้าในตัวจัดการเทมเพลตเพื่อตรวจจับวัตถุหรือจำแนกภาพ เลือกชนิดโมเดลให้ถูกต้องที่นั่น รองรับเอาต์พุต: ตรวจจับ YOLOv8/YOLO11 [1,N,4+C]/[1,4+C,N]; ตรวจจับ YOLO26 [1,N,6]/[N,6]; จำแนก YOLO11/YOLO26 และ MobileNetV3 [1,C] รองรับ FLOAT32, INT8 และ UINT8 โดยอัตโนมัติ การจำแนกคืนคะแนนและข้อมูลคลาสโดยไม่มีจุดหรือกรอบบนหน้าจอ การรันต้องมีไฟล์โมเดลในเครื่อง หากหาไฟล์ไม่ได้จะเกิดข้อผิดพลาด
- →
TimerClassTimer(auto_start=True)วัดเวลาที่ผ่านไปเป็นมิลลิวินาที หยุดชั่วคราวแล้วนับต่อโดยไม่เสียเวลาที่นับแล้ว
- →
TouchClassTouchจัดการการคลิกและปัดแบบขนานจากสคริปต์หรือแอ็กชันของมาโคร: จัดกลุ่ม ดูความคืบหน้า รอ หรือยกเลิก ในสคริปต์ใช้ click(..., parallel=True) หรือ swipe(..., parallel=True) ต้องเปิดบริการการช่วยเหลือพิเศษของ CogniTab เพื่อส่งท่าทาง
🔒 คลาสแบบอ่านอย่างเดียว
7 หัวข้อ- →
AudioMatchRead-only ClassAudioMatchผลการจับคู่เสียงแบบอ่านอย่างเดียว คะแนนคือความคล้าย ไม่ใช่ความน่าจะเป็นของความถูกต้อง เวลาใน find() ใช้เส้นเวลาของเซสชันฟัง ส่วน match() ใช้เส้นเวลาของค่าเสียงที่ค้นหา เปรียบเทียบเวลาเพื่อไม่จัดการเสียงเดียวซ้ำ ใช้เวลาเป็นเหตุการณ์ตรวจพบเฉพาะเมื่อ matched เป็น True
- →
FlowRead-only ClassFlowเรียกโฟลว์แมโครที่มีชื่อให้ทำงานพร้อมกันและส่งข้อความระหว่างกัน แต่ละโฟลว์มีตัวแปรของตน ส่งข้อมูลเริ่มต้นผ่าน Flow.params ข้อความเป็นสำเนาอิสระและอ่านตามลำดับที่ส่ง
- →
MatchRead-only ClassMatchอ่านผลการค้นหาด้วยการจดจำ ตรวจ found ก่อนแตะหรือใช้ตำแหน่ง เพราะการค้นหาภาพที่ไม่สำเร็จอาจยังมีตำแหน่งของภาพที่ใกล้เคียงที่สุด
- →
MatchListRead-only ClassMatchListอ่านผลการจดจำหลายรายการเป็นลิสต์ของ Match ใช้ len(matches), matches[index] หรือลูป for ลิสต์ที่ไม่ว่างอาจมีรายการที่ไม่พบ โดยเฉพาะหลัง wait_any()/wait_all(); ตรวจ found ของแต่ละรายการ
- →
MotionResultRead-only ClassMotionResultผลลัพธ์อ่านอย่างเดียวจาก MotionTracker.update() การเลื่อนแสดงการเคลื่อนของพื้นหลังระหว่างเฟรม ไม่ใช่ตำแหน่งสัมบูรณ์ การติดตามไม่คลิก ส่งอินพุต อัปโหลด หรือบันทึกข้อมูล
- →
RecognitionRead-only ClassRecognitionใช้ในสาขาความสำเร็จในการจดจำใน UI Recognition.result ส่งคืนการจับคู่สำหรับหนึ่งเป้าหมายการรับรู้หรือ MatchList เมื่อหลายเป้าหมายตรงกัน
- →
TouchStateRead-only ClassTouchState(id, status, kind, action_order, remaining_repeats, completed_repeats)สถานะของการคลิกหรือปัดแบบขนาน ณ เวลาที่สอบถาม รับผ่านเมธอดของ Touch และจะไม่อัปเดตเอง
📚 คอลเลกชัน
6 หัวข้อ- →
dictCollectiondict(mapping_or_pairs=(), /, **items)เก็บค่าภายใต้คีย์และอ่านด้วยคีย์ คีย์คงลำดับที่เพิ่ม การเขียนคีย์เดิมจะแทนที่ค่าโดยไม่ย้ายตำแหน่งคีย์ แต่ละคีย์มีหนึ่งค่า
- →
listCollectionlist(iterable=(), /)เก็บรายการตามลำดับ โดยมีค่าซ้ำได้ อ่านตำแหน่งเริ่มที่ 0 วนลูปผ่านรายการ หรือเพิ่ม แทนที่ และลบรายการใน list เดิมได้
- →
rangeCollectionrange(stop, /) | range(start, stop, step=1, /)ลำดับจำนวนเต็มที่เปลี่ยนแปลงไม่ได้ สร้างด้วย range() ใช้ลำดับซ้ำได้โดยไม่ต้องสร้างรายการทั้งหมด และใช้ list() เมื่อต้องการรายการ
- →
setCollectionset(iterable=(), /)เก็บค่าโดยไม่ซ้ำและเพิ่มหรือลบภายหลังได้ ค่าที่เท่ากันปรากฏครั้งเดียว: True, 1 และ 1.0 เท่ากัน รายการต้องใช้เป็นคีย์ dictionary ได้ จึงไม่รับ list, dictionary, set หรือ tuple ที่มีสิ่งเหล่านี้ อย่าพึ่งพาลำดับการวนลูป
- →
StringCollectionStringเก็บข้อความที่เขียนในเครื่องหมายคำพูดหรือแปลงด้วย str(value) แก้ไขสตริงเดิมโดยตรงไม่ได้ เมธอดของสตริงคืนค่าใหม่ ตำแหน่งและความยาวนับตามจุดรหัส Unicode: อีโมจิหนึ่งตัวใช้หนึ่งตำแหน่ง แต่ตัวอักษรที่มีเครื่องหมายกำกับแยกหรืออีโมจิที่ประกอบกันอาจใช้หลายตำแหน่ง
- →
tupleCollectiontuple(iterable=(), /) (value1, value2, ...)เก็บรายการตามลำดับและมีค่าซ้ำได้ แต่เพิ่ม ลบ หรือแทนที่หลังสร้างไม่ได้ list หรือ dictionary ที่ซ้อนอยู่ยังเปลี่ยนได้ ในเงื่อนไข tuple ว่างเป็น false และ tuple ที่มีรายการเป็น true
⚡ ฟังก์ชัน
36 หัวข้อการแตะและปัด
2 หัวข้อ- →
clickFunctionclick(target, hold_ms=0, offset=(0, 0), random=0, delay_before=0, delay_after=0, parallel=False)กดแล้วปล่อยที่จุดเป้าหมายแต่ละจุด โดยปกติจะรอให้การกดเสร็จก่อนทำงานต่อ ระบุอาร์กิวเมนต์ตามตำแหน่งหรือตามชื่อได้ตามลำดับที่ระบุไว้
- →
swipeFunctionswipe(points, *, parallel=False)เลื่อนหนึ่งนิ้วผ่านค่า SwipePoint ตามลำดับ โดยปกติจะรอให้การปัดเสร็จก่อนทำงานต่อ
การป้อนข้อมูล
1 หัวข้อควบคุมลำดับการทำงาน
5 หัวข้อ- →
printFunctionprint(*values, sep=" ", end="\n")เขียนค่าลงในคอนโซลสคริปต์บนหน้าต่างลอยแล้วทำงานต่อ โดยใช้ข้อความแบบเดียวกับ str(value)
- →
randomFunctionrandom()ส่งกลับตัวเลขทศนิยมแบบสุ่มในช่วง 0 -> 1
- →
random_intFunctionrandom_int(min, max, /)ส่งกลับจำนวนเต็มสุ่มในช่วงขั้นต่ำ -> สูงสุด
- →
rangeFunctionrange(stop, /) | range(start, stop, step=1, /)สร้างลำดับของจำนวนเต็มเพื่อใช้ใน for-loop
- →
waitFunctionwait(ms, /)หยุดการทำงานของสคริปต์ชั่วคราวตามจำนวนมิลลิวินาทีที่กำหนด
คอลเลกชัน
7 หัวข้อ- →
allFunctionall(iterable, /)คืน False เมื่อพบสมาชิก falsy ตัวแรก มิฉะนั้นคืน True รวมถึง iterable ว่าง ใช้การวนซ้ำและทดสอบค่าความจริงตามปกติ รองรับการหยุดชั่วคราวและหยุด
- →
anyFunctionany(iterable, /)คืนค่า True หากมีอย่างน้อยหนึ่งรายการใน iterable ที่เป็นค่าจริง (truthy) โดยหยุดที่รายการแรกที่เป็นจริง และคืนค่า False เมื่อ iterable ว่างหรือทุกรายการเป็นเท็จ (falsy)
- →
enumerateFunctionenumerate(iterable, start=0)ใส่หมายเลขให้สมาชิกนำเข้าในขณะที่วนซ้ำ
- →
globalsFunctionglobals()คืนค่า dict แบบสดของตัวแปร ฟังก์ชัน และคลาสระดับโกลบอลของสคริปต์ในการรันปัจจุบัน
- →
lenFunctionlen(value, /)รับขนาดของสตริง รายการ/สิ่งอันดับ หรือ dict
- →
sortedFunctionsorted(iterable, /, *, key=None, reverse=False)คืนรายการใหม่ที่เรียงจากน้อยไปมาก สมาชิกที่มีค่าเปรียบเทียบเท่ากันจะคงลำดับเดิมไว้ แม้ใช้ reverse=True
- →
zipFunctionzip(*iterables, strict=False)จับคู่สมาชิกที่อยู่ตำแหน่งเดียวกันของแต่ละข้อมูลนำเข้าขณะวนซ้ำ
แปลงชนิดข้อมูล
7 หัวข้อ- →
boolFunctionbool(value=False, /)แปลง value เป็น True หรือ False เพื่อใช้ในเงื่อนไข
- →
floatFunctionfloat(value=0.0, /)แปลง value เป็นเลขทศนิยม ข้อความต้องเป็นตัวเลขที่ถูกต้อง; True กลายเป็น 1.0 และ False กลายเป็น 0.0
- →
hasattrFunctionhasattr(object, name, /)ตรวจสอบว่าออบเจ็กต์มีแอตทริบิวต์หรือเมธอดหรือไม่ โดยใช้การค้นหาแอตทริบิวต์ตามปกติของ DSL และไม่เรียกเมธอด
- →
intFunctionint(value=0, /)แปลง value เป็นจำนวนเต็มโดยตัดส่วนทศนิยมของข้อมูลตัวเลขออก ข้อความต้องเป็นจำนวนเต็ม; ข้อความที่มีทศนิยมทำให้เกิดข้อผิดพลาด True กลายเป็น 1 และ False กลายเป็น 0
- →
isinstanceFunctionisinstance(value, class_or_tuple, /)ตรวจสอบว่าค่าเป็นชนิดในตัว คลาสค่าของ DSL หรือคลาสที่ผู้ใช้กำหนดเอง โดยไม่แปลงค่า
- →
strFunctionstr(value="", /)แปลง value เป็นข้อความ โดยคงสตริงเดิมไว้ ตัวเลขและคอลเลกชันมาตรฐานใช้รูปแบบข้อความของ Python
- →
typeFunctiontype(value, /)ส่งกลับสตริงอธิบายคลาสที่มีลักษณะคล้าย Python สำหรับค่า เช่น <class 'int'>
คณิตศาสตร์
14 หัวข้อ- →
absFunctionabs(value, /)ส่งกลับค่าสัมบูรณ์
- →
ceilFunctionceil(value, /)ส่งกลับจำนวนเต็มที่น้อยที่สุดซึ่งไม่เล็กกว่าค่า
- →
clampFunctionclamp(value, min, max, /)จำกัด value ให้อยู่ระหว่าง min และ max: แทนค่าที่อยู่นอกช่วงด้วยขอบเขตที่ใกล้ที่สุด สามารถระบุขอบเขตในลำดับสลับกันได้
- →
cosFunctioncos(value, /)ส่งคืนค่าโคไซน์ของค่าเป็นเรเดียน
- →
floorFunctionfloor(value, /)ส่งกลับจำนวนเต็มที่มากที่สุดไม่เกินค่า
- →
logFunctionlog(value, base=None, /)ส่งกลับลอการิทึมของค่า ใช้บันทึกธรรมชาติเมื่อละเว้นฐาน
- →
maxFunctionmax(iterable, /, *, key=None) | max(iterable, /, *, default, key=None) | max(arg1, arg2, /, *args, key=None)ส่งคืนรายการที่ใหญ่ที่สุดจากอาร์กิวเมนต์ที่ทำซ้ำได้หนึ่งรายการหรืออาร์กิวเมนต์ที่ใหญ่ที่สุดตั้งแต่สองรายการขึ้นไป คีย์สามารถคำนวณค่าที่ใช้ในการสั่งซื้อได้ ความสัมพันธ์จะเก็บสิ่งแรกที่พบ
- →
minFunctionmin(iterable, /, *, key=None) | min(iterable, /, *, default, key=None) | min(arg1, arg2, /, *args, key=None)ส่งคืนรายการที่เล็กที่สุดจากอาร์กิวเมนต์ที่ทำซ้ำได้หนึ่งรายการหรืออาร์กิวเมนต์ที่น้อยที่สุดจากสองอาร์กิวเมนต์ขึ้นไป คีย์สามารถคำนวณค่าที่ใช้ในการสั่งซื้อได้ ความสัมพันธ์จะเก็บสิ่งแรกที่พบ
- →
powFunctionpow(base, exponent, /)ยกฐานให้เป็นเลขชี้กำลัง
- →
roundFunctionround(number, ndigits=None)ปัดเศษให้เป็นจำนวนหลักทศนิยมที่กำหนด
- →
sinFunctionsin(value, /)ส่งคืนค่าไซน์ของค่าเป็นเรเดียน
- →
sqrtFunctionsqrt(value, /)ส่งคืนค่ารากที่สองของค่าที่ไม่เป็นลบ
- →
sumFunctionsum(iterable, /, start=0)บวกตัวเลขนำเข้ากับ start แล้วคืนผลรวม
- →
tanFunctiontan(value, /)ส่งคืนค่าแทนเจนต์เป็นเรเดียน