แค็ตตาล็อก API ของ Runtime V2
57 หัวข้อรายการคลาส คอลเลกชัน และฟังก์ชันอัตโนมัติในตัวทั้งหมดที่ใช้ได้ใน CogniTab Script Runtime
📦 คลาส
15 หัวข้อ- →
AudioClassAudio(name)ค่าเสียงแบบอ่านอย่างเดียวสำหรับตรวจจับเสียงในแอปหรือเกม ใช้ Audio(name) เพื่อโหลดตัวอย่างที่บันทึกไว้ หรือ Audio.recent(duration_ms) เพื่อคัดลอกเสียงที่เพิ่งจับมา การจับและจับคู่เสียงทำบนอุปกรณ์ โดยไม่อัปโหลดบัฟเฟอร์การฟังต่อเนื่องและไม่ให้สคริปต์เข้าถึงข้อมูลเสียงดิบ (PCM)
- →
ColorClassColor(value, /)แสดงถึงสี ARGB หนึ่งสี และจัดเตรียมตัวช่วยในการสุ่มตัวอย่าง/เปรียบเทียบสี
- →
MacroPanelClassMacroPanel(title="", subtitle="", confirm_text="Run", cancel_text="Cancel", *, version="")สร้างและแสดงแผงอินพุตรันไทม์สำหรับพารามิเตอร์มาโครที่ควบคุมสคริปต์
- →
OverlayTextClassOverlayText(text="", position=(0, 0), color="#FFFFFFFF", size=16, background=None)วาดข้อความที่ด้านบนของหน้าจอด้วยการติดตามการโต้ตอบที่เป็นตัวเลือก (กด/ย้าย/กดค้างไว้) ชื่อตัวตั้งค่าเช่นข้อความ/พื้นหลังเป็นวิธีการ อ่านค่าปัจจุบันผ่าน state()
- →
PointClassPoint(x, y, /, scale="fixed", anchor="none")จุดบนหน้าจอ วัดเป็นพิกเซล การแมปพิกัดการควบคุมมาตราส่วน/จุดยึดข้ามขนาดหน้าจอ หลังจากการแมปและออฟเซ็ต ผู้ใช้รันไทม์จะยึดจุดสุดท้ายไว้ที่ช่วงพิกเซลที่ถูกต้องของหน้าจอปัจจุบัน จุดสามารถทำลายโครงสร้างได้เป็น x, y
- →
RegionClassRegion(x, y, width, height, /, scale="fixed", anchor="none", scale_param=ScaleParam())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.
- →
ScaleParamClassScaleParam(grayscale=True, auto_scale=False, cache_scale=True, template_scale="SHORT_EDGE", fast_matching=False)พารามิเตอร์การจับคู่เทมเพลตสำหรับ Region โดย fast_matching จะลดขนาดทั้งภาพ Region และเทมเพลต
- →
ScreenCaptureClassScreenCaptureชุดควบคุมการจับภาพหน้าจอร่วมกันในการรันมาโครปัจจุบัน โดยปกติแคชอัตโนมัติจะใช้เฟรมซ้ำได้นานถึง 100 ms เพื่อลดงานจับภาพ หากต้องตรวจจับต่อเนื่องโดยใช้เฟรมล่าสุดที่มี ให้ใช้ auto_cache_off() ซึ่งเพิ่มภาระประมวลผลและการใช้แบตเตอรี่ ไม่รับประกันว่าจะทำงานเร็วขึ้นหรือได้พิกเซลที่เพิ่งวาดใหม่ ส่วน cache_on() จะปักหมุดเฟรมแยกต่างหากและมีลำดับความสำคัญเหนือการตั้งค่าแคชอัตโนมัติ
- →
StorageClassStorageStorage คีย์/ค่าแบบถาวรสำหรับมาโครปัจจุบัน ตัวแปรปกติใช้ร่วมกันเฉพาะระหว่าง action PYTHON_CODE ที่ทำงานตามลำดับภายใน flow เดียว รวมถึง action ใน GROUP ส่วน flow ที่ทำงานพร้อมกันจะแยกตัวแปรออกจากกัน คีย์ Storage ใช้ร่วมกันในทุก flow จึงควรใช้เมื่อค่าต้องคงอยู่ถึงการรันมาโครครั้งถัดไป ไม่ใช่เป็นช่องส่งข้อความระหว่างโปรเซส การเขียนจะถูกบันทึกอัตโนมัติหลังไม่มีการเขียนใหม่ 2 วินาที และ commit อีกครั้งเมื่อ Run ทั้งหมดและ flow เบื้องหลังทั้งหมดสิ้นสุด
- →
SwipePointClassSwipePoint(point, speed="NORMAL", delay_before=0, random=10, humanized=False, scale="fixed", anchor="none")จุดหนึ่งในเส้นทางการปัดแบบเรียบ จุดจะต้องเป็นจุดหรือทูเพิล (x, y) Pass a list of at least two SwipePoint values to swipe([...]) to move one finger through multiple points.
- →
SystemClassSystem()เข้าถึงข้อมูลระบบ/อุปกรณ์รันไทม์และทริกเกอร์การดำเนินการระดับระบบจากสคริปต์
- →
TemplateClassTemplate(name, /)Wrapper รูปภาพเทมเพลต คุณสามารถปรับขนาด/ครอบตัดเทมเพลตที่มีอยู่ บันทึกเป็นชื่อเทมเพลตใหม่ หรือตรวจสอบการมีอยู่ได้
- →
TfliteModelClassTfliteModel(model)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.
- →
TimerClassTimer(auto_start=True)ตัวช่วยนาฬิกาจับเวลาระดับมิลลิวินาทีสำหรับตรวจสอบเวลาสคริปต์และการรอคอยที่ปลอดภัย
- →
TouchClassTouchตัวช่วยแบบคงที่สำหรับการคลิก/การปัดแบบขนานที่สร้างโดย UI หรือโค้ดผ่านการคลิก(..., Parallel=True) และ การปัด(..., Parallel=True) คุณสามารถรวบรวมการดำเนินการคลิก/ปัดแล้วส่งพร้อมกัน หรือตรวจสอบการดำเนินการคลิก/ปัดที่ทำงานอยู่หรืออยู่ในคิว ตัวช่วยยังรองรับการยกเลิกการดำเนินการคลิก/ปัดนิ้วที่ใช้งานอยู่ (เฉพาะ Android 8.0 ขึ้นไป)
🔒 คลาสแบบอ่านอย่างเดียว
6 หัวข้อ- →
AudioMatchRead-only ClassAudioMatchผลการจับคู่เสียงแบบอ่านอย่างเดียว คะแนนคือความคล้าย ไม่ใช่ความน่าจะเป็นของความถูกต้อง เวลาใน find() ใช้เส้นเวลาของเซสชันฟัง ส่วน match() ใช้เส้นเวลาของค่าเสียงที่ค้นหา เปรียบเทียบเวลาเพื่อไม่จัดการเสียงเดียวซ้ำ ใช้เวลาเป็นเหตุการณ์ตรวจพบเฉพาะเมื่อ matched เป็น True
- →
FlowRead-only ClassFlowการควบคุมแบบ static สำหรับเริ่ม flow ของมาโครที่ตั้งชื่อให้ทำงานพร้อมกัน ได้สูงสุดสอง flow เบื้องหลังข้าง main flow และแต่ละชื่อมี invocation ที่ยังทำงานได้เพียงหนึ่งรายการ รวมช่วง pause หรือ stopping ด้วย Flow.start() คืนค่าทันทีเมื่อ coordinator รับ branch แล้ว flow เบื้องหลังเริ่ม flow เพื่อนได้ ตัวแปรแยกตาม branch และไม่รวมกลับไปยังผู้เรียก main flow จะรอ flow เบื้องหลังทั้งหมดก่อน Run จบ ชื่อผิดหรือซ้ำ พื้นที่ flow เต็ม ข้อผิดพลาดของ branch ใด ๆ System.stop() หรือ Main Stop จะจบมาโครทั้งหมด ปุ่ม dock ของ flow เบื้องหลังแต่ละหมายเลขทำได้เพียง Pause หรือ Resume ชั่วคราวเฉพาะ branch นั้น ไม่มี Stop เฉพาะ branch Pause หรือ Resume ของ Main ใช้กับทุก branch และ Resume ทั่วโลกจะล้างสถานะ pause เฉพาะ branch ด้วย gesture สัมผัสจากต่าง branch อาจยกเลิกกันเอง นโยบาย ScreenCapture และ audio capture ใช้ร่วมกันทั่วโลก Storage ใช้คีย์ถาวรร่วมกันระหว่าง branch และไม่ใช่ช่องส่งข้อความระหว่างโปรเซส
- →
MatchRead-only ClassMatchผลการจับคู่การจดจำแบบอ่านอย่างเดียวที่ส่งคืนโดยผู้ช่วยเหลือ Region.find* ในสาขาความสำเร็จของการจดจำ Recognition.result ชี้ไปที่ Match หรือ MatchList ที่ใช้งานอยู่
- →
MatchListRead-only ClassMatchListรายการค่าการจับคู่แบบอ่านอย่างเดียวที่ส่งคืนโดย Region.find_any/find_all/find_multi, wait_any/wait_all และ Recognition.result เมื่อเป้าหมายการจดจำหลายรายการตรงกัน
- →
RecognitionRead-only ClassRecognitionใช้ในสาขาความสำเร็จในการจดจำใน UI Recognition.result ส่งคืนการจับคู่สำหรับหนึ่งเป้าหมายการรับรู้หรือ MatchList เมื่อหลายเป้าหมายตรงกัน
- →
TouchStateRead-only ClassTouchState(id, status, kind, action_order, remaining_repeats, completed_repeats)สแนปชอตของรายการสัมผัสสคริปต์/UI หนึ่งรายการในคิวท่าทางสัมผัสที่ใช้ร่วมกัน
📚 คอลเลกชัน
5 หัวข้อ- →
dictCollectiondict(mapping_or_pairs=(), /, **items)คอลเลกชันคีย์/ค่าที่เก็บลำดับการแทรกและสามารถอ่านหรืออัปเดตได้ระหว่างการเรียกใช้สคริปต์
- →
listCollectionlist(iterable=(), /)คอลเลกชันที่เรียงลำดับคุณสามารถสร้าง อ่าน วนซ้ำ ทำลายโครงสร้าง และอัปเดตในขณะที่สคริปต์ทำงาน
- →
setCollectionset(iterable=None, /)คอลเลกชันของค่าที่ไม่ซ้ำที่ไม่แน่นอน CogniTab รักษาลำดับการวนซ้ำให้คงที่ ดังนั้นเอาต์พุตสคริปต์จึงอ่านง่าย
- →
StringCollectionStringการรวบรวมค่าข้อความ สร้างโดยตัวอักษรสตริงหรือ str(value) จากนั้นอ่านตามความยาว/ดัชนี/การดำเนินการวนซ้ำ
- →
tupleCollectiontuple(iterable=(), /) (value1, value2, ...)คอลเลกชันแบบอ่านอย่างเดียวที่สั่งซื้อ ใช้ตัวอักษรทูเปิลเมื่อค่าควรคงที่หลังจากการสร้างหรือเมื่อส่งคืนค่าที่จัดกลุ่มเพื่อทำลายโครงสร้าง
⚡ ฟังก์ชัน
31 หัวข้อการแตะและปัด
2 หัวข้อ- →
clickFunctionclick(target, hold_ms=0, offset=(0, 0), random=0, delay_before=0, delay_after=0, parallel=False)คลิกที่ Point, tuple (x, y), Match หรือ MatchList ทุกพารามิเตอร์รองรับรูปแบบตามตำแหน่งหรือระบุชื่อตามลำดับในเอกสาร ใช้ Point(x, y) สำหรับ metadata ของพิกัด เช่น scale/anchor; ใช้ (x, y) สำหรับพิกัดพิกเซลคงที่ ใช้ parallel=True เพื่อเข้าคิวการแตะนี้และรับ id แบบตัวเลข; เรียก Touch.cancel(id) หรือ Touch.cancel() เพื่อยกเลิก touch ที่อยู่ในคิวหรือกำลังทำงาน
- →
swipeFunctionswipe(points, *, parallel=False)Perform a swipe gesture from a flat list of SwipePoint values. Each list creates one multi-point path for one finger.
การป้อนข้อมูล
1 หัวข้อควบคุมลำดับการทำงาน
5 หัวข้อ- →
printFunctionprint(*values, sep=" ", end="\n")Write values to the overlay script console without blocking execution. Structured values use the same bounded display formatter as str(value), including row-based pretty output for two-dimensional lists, multi-line output for complex nesting, and explicit markers when content is omitted.
- →
randomFunctionrandom()ส่งกลับตัวเลขทศนิยมแบบสุ่มในช่วง 0 -> 1
- →
random_intFunctionrandom_int(min, max, /)ส่งกลับจำนวนเต็มสุ่มในช่วงขั้นต่ำ -> สูงสุด
- →
rangeFunctionrange(stop, /) | range(start, stop, step=1, /)สร้างลำดับของจำนวนเต็มเพื่อใช้ใน for-loop
- →
waitFunctionwait(ms, /)Pause script execution for a given number of milliseconds.
คอลเลกชัน
4 หัวข้อ- →
enumerateFunctionenumerate(iterable, start=0)ส่งคืนรายการคู่ tuple(index, item) สำหรับค่าที่สามารถทำซ้ำได้
- →
lenFunctionlen(value, /)รับขนาดของสตริง รายการ/สิ่งอันดับ หรือ dict
- →
sortedFunctionsorted(iterable, /, *, key=None, reverse=False)ส่งคืนรายการใหม่ที่มีรายการทั้งหมดจาก iterable ตามลำดับที่จัดเรียง คีย์สามารถคำนวณคีย์เปรียบเทียบ Reverse=True เรียงลำดับจากมากไปหาน้อยโดยยังคงรักษารายการที่มีคีย์เท่ากันให้คงที่
- →
zipFunctionzip(*iterables)รวมสิ่งที่ทำซ้ำได้ลงในรายการสิ่งอันดับ โดยหยุดที่อินพุตที่สั้นที่สุด
แปลงชนิดข้อมูล
5 หัวข้อ- →
boolFunctionbool(value, /)แปลงค่าเป็นบูลีนโดยใช้กฎความจริง/เท็จของสคริปต์
- →
floatFunctionfloat(value, /)ส่งค่าเป็นเลขทศนิยม
- →
intFunctionint(value, /)โยนค่าเป็นจำนวนเต็ม (ตัดทอนส่วนทศนิยม)
- →
strFunctionstr(value, /)Convert value to string using DSL display format. Point/Region stay compact, two-dimensional lists render as one row list per line, and only rows that are too long or complex expand into vertical multi-line text. Large or deeply nested structured values use a bounded preview with explicit omitted/budget markers; a direct string value remains unchanged.
- →
typeFunctiontype(value, /)ส่งกลับสตริงอธิบายคลาสที่มีลักษณะคล้าย Python สำหรับค่า เช่น <class 'int'>
คณิตศาสตร์
14 หัวข้อ- →
absFunctionabs(value, /)ส่งกลับค่าสัมบูรณ์
- →
ceilFunctionceil(value, /)ส่งกลับจำนวนเต็มที่น้อยที่สุดซึ่งไม่เล็กกว่าค่า
- →
clampFunctionclamp(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(value, digits=0, /)ปัดเศษให้เป็นจำนวนหลักทศนิยมที่กำหนด
- →
sinFunctionsin(value, /)ส่งคืนค่าไซน์ของค่าเป็นเรเดียน
- →
sqrtFunctionsqrt(value, /)ส่งคืนค่ารากที่สองของค่าที่ไม่เป็นลบ
- →
sumFunctionsum(iterable, /, start=0)คืนค่าผลรวมของตัวเลขใน iterable โดยเลือกกำหนดค่าเริ่มต้น start ได้ สามารถละวงเล็บของ generator expression ได้เฉพาะเมื่อเป็นอาร์กิวเมนต์เดียวในการเรียกฟังก์ชันหรือเมธอด หากมีอาร์กิวเมนต์อื่นหรือเครื่องหมายจุลภาคท้ายรายการ ต้องใส่วงเล็บครอบ generator
- →
tanFunctiontan(value, /)ส่งคืนค่าแทนเจนต์เป็นเรเดียน