Danh mục API Runtime V2

Giá trị âm thanh chỉ đọc dùng để nhận diện tiếng động trong app hoặc game. Dùng Audio(name) để nạp mẫu đã lưu, hoặc Audio.recent(duration_ms) để lấy đoạn âm thanh vừa thu. Thu và so khớp trên thiết bị; bộ đệm nghe liên tục không được tải lên và script không truy cập âm thanh thô (PCM).

Lưu một màu, lấy màu trên màn hình hoặc so sánh các màu. ARGB gồm độ đục (A), đỏ (R), xanh lá (G) và xanh dương (B); compare(), distance_rgb() và delta_e() bỏ qua độ đục.

Tạo bảng để người dùng nhập thiết lập cho macro. Thêm các ô nhập rồi gọi show() để hiển thị bảng.

Theo dõi độ tịnh tiến của nền giữa các khung hình bằng OpenCV với nhiều vùng mẫu. Khi tạo không chụp khung hình; mỗi flow được mở tối đa 16 tracker. Công cụ không nhận diện nhân vật hay định vị trên bản đồ. Hãy loại HUD và nhân vật; xử lý mức zoom của game bên ngoài bằng so khớp mẫu và tỷ lệ. Khi nghi có zoom hoặc xoay, kết quả là LOST, không phải ước lượng zoom.

Tạo chữ nổi trên các app khác. Gọi show() để hiển thị và áp dụng các thay đổi sau đó. Dùng track() để bật theo dõi nhấn, kéo hoặc giữ. Đọc giá trị hiện tại bằng state(); text() và background() là phương thức.

Một vị trí theo pixel trên màn hình, dùng để nhấn, vuốt và đánh dấu. Scale và anchor giúp điều chỉnh vị trí khi kích thước màn hình thay đổi; vị trí cuối được giới hạn trong màn hình. Đọc hai tọa độ bằng x, y = point.

Một vùng chữ nhật trên màn hình để tìm ảnh hoặc màu, chụp ảnh hoặc vẽ khung đánh dấu. Tọa độ dùng pixel theo trục ngang/dọc hiện tại; sau khi điều chỉnh kích thước và độ lệch, chỉ phần trong màn hình được sử dụng. Đọc kích thước bằng x, y, width, height = region.

Cài đặt tìm ảnh mẫu trong Region. Truyền đối tượng này vào scale_param của Region; các cài đặt này không thay đổi tọa độ vùng.

Điều khiển việc dùng lại ảnh chụp khi nhận diện màn hình trong lượt chạy macro hiện tại. Thông thường, một ảnh chụp có thể được dùng lại trong tối đa 100 ms. Gọi trực tiếp các phương thức trên ScreenCapture; không tạo đối tượng.

Lưu giá trị theo tên để macro hiện tại dùng lại ở các lần chạy sau. Mọi luồng trong cùng lượt chạy dùng chung Storage; biến thường chỉ dùng chung giữa các action PYTHON_CODE tuần tự trong một luồng, kể cả trong GROUP. Các luồng song song có biến riêng. Storage không phải kênh gửi tin giữa các tiến trình.

Một vị trí kèm cài đặt di chuyển cho một bước vuốt. Truyền danh sách ít nhất hai đối tượng SwipePoint vào swipe([...]) để một ngón tay đi qua các vị trí đó.

Truy cập thông tin hệ thống/thiết bị và gọi hành động hệ thống từ script.

Dùng ảnh đã lưu làm mẫu nhận diện. Bạn có thể đổi kích thước hoặc cắt ảnh thành Template riêng, rồi lưu kết quả bằng save_as().

Dùng model TFLite đã nhập trong Trình quản lý mẫu để nhận diện đối tượng hoặc phân loại ảnh. Chọn đúng loại model tại đó. Đầu ra hỗ trợ: nhận diện YOLOv8/YOLO11 [1,N,4+C]/[1,4+C,N]; nhận diện YOLO26 [1,N,6]/[N,6]; phân loại YOLO11/YOLO26 và MobileNetV3 [1,C]. Tự động hỗ trợ FLOAT32, INT8 và UINT8. Phân loại trả điểm và thông tin lớp, không có điểm hoặc vùng trên màn hình. Chạy model cần tệp cục bộ; không lấy được tệp sẽ báo lỗi.

Đo thời gian đã trôi qua bằng mili giây. Tạm dừng rồi đếm tiếp mà không mất thời gian đã đếm.

Quản lý các lần nhấn và vuốt song song từ script hoặc action của macro: gom nhóm, xem tiến độ, chờ hoặc hủy. Trong script, dùng click(..., parallel=True) hoặc swipe(..., parallel=True). Gửi thao tác cần bật dịch vụ Trợ năng của CogniTab.

Kết quả so khớp âm thanh chỉ đọc. Điểm là mức tương đồng, không phải xác suất chính xác. Mốc thời gian của find() tính từ đầu phiên nghe; match() dùng mốc thời gian của giá trị âm thanh được tìm kiếm. So sánh mốc thời gian để tránh xử lý lặp cùng một âm thanh. Chỉ dùng mốc thời gian làm lần phát hiện khi matched là True.

Chạy song song các luồng macro có tên và gửi tin nhắn giữa chúng. Mỗi luồng có biến riêng. Truyền dữ liệu ban đầu qua Flow.params; tin nhắn là bản sao độc lập, được đọc theo thứ tự gửi.

Đọc kết quả của một lần tìm kiếm nhận diện. Kiểm tra found trước khi nhấn hoặc dùng vị trí; lần tìm ảnh thất bại vẫn có thể chứa vị trí ứng viên giống nhất.

Đọc nhiều kết quả nhận diện dưới dạng list các Match. Dùng len(matches), matches[index] hoặc vòng lặp for. List có phần tử vẫn có thể chứa kết quả không tìm thấy, nhất là sau wait_any()/wait_all(); hãy kiểm tra found của từng phần tử.

Kết quả chỉ đọc từ MotionTracker.update(). Độ tịnh tiến mô tả chuyển động của nền giữa hai khung hình, không phải vị trí tuyệt đối. Theo dõi không nhấn, gửi thao tác nhập, tải lên hay lưu dữ liệu.

Được dùng trong nhánh thành công của nhận diện trong UI. Recognition.result trả về Match khi có một mục tiêu nhận diện khớp hoặc MatchList khi nhiều mục tiêu cùng khớp.

Trạng thái của một lần nhấn hoặc vuốt song song tại thời điểm truy vấn. Lấy đối tượng này qua các hàm Touch; trạng thái không tự cập nhật.

Lưu giá trị dưới các khóa và đọc bằng khóa. Khóa giữ thứ tự thêm vào; ghi vào khóa đã có sẽ thay giá trị mà không đổi vị trí khóa. Mỗi khóa có một giá trị.

Lưu các phần tử theo thứ tự, cho phép giá trị trùng nhau. Đọc vị trí bắt đầu từ 0, lặp qua phần tử, hoặc thêm, thay thế và xóa phần tử trong chính list đó.

Dãy số nguyên không thể thay đổi, được tạo bằng range(). Bạn có thể dùng lại dãy mà không cần tạo toàn bộ danh sách; dùng list() khi cần danh sách.

Lưu giá trị không trùng nhau, có thể thêm hoặc xóa sau đó. Giá trị bằng nhau chỉ xuất hiện một lần: True, 1 và 1.0 bằng nhau. Phần tử phải dùng được làm khóa dictionary; list, dictionary, set hoặc tuple chứa chúng bị từ chối. Không phụ thuộc vào thứ tự lặp.

Lưu văn bản viết trong dấu nháy hoặc chuyển bằng str(value). Không thể sửa trực tiếp chuỗi; các phương thức chuỗi trả về giá trị mới. Vị trí và độ dài đếm theo mã Unicode: một emoji là một vị trí, nhưng chữ kèm dấu tách riêng hay emoji ghép có thể chiếm nhiều vị trí.

Lưu phần tử theo thứ tự, cho phép trùng nhau, nhưng không thể thêm, xóa hay thay thế sau khi tạo. List hay dictionary lồng bên trong vẫn có thể thay đổi. Trong điều kiện, tuple rỗng là false, tuple có phần tử là true.