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).

Đại diện cho một màu ARGB và cung cấp helper lấy màu/so sánh màu.

Tạo và hiển thị panel nhập liệu runtime cho tham số macro trong script.

Vẽ text đè lên màn hình với tùy chọn theo dõi tương tác (ấn/kéo/giữ). Các tên setter như text/background là method; đọc giá trị hiện tại qua state().

Một điểm trên màn hình, đo bằng pixel. Scale/anchor điều khiển cách quy đổi tọa độ giữa các kích thước màn hình. Sau khi quy đổi và cộng offset, runtime sẽ clamp point cuối vào khoảng pixel hợp lệ của màn hình hiện tại. Point có thể bung giá trị thành x, y.

Một vùng hình chữ nhật trên màn hình, đo bằng pixel theo trục màn hình hiện tại. Scale/anchor điều khiển cách quy đổi tọa độ theo kích thước toàn màn hình, không xoay qua hệ tọa độ portrait và không dùng app viewport; runtime sẽ clip region cuối vào màn hình hiện tại sau khi quy đổi và cộng offset. ScaleParam điều khiển nhận diện template trong region này. Region có thể bung giá trị thành x, y, width, height.

Các tham số so khớp template cho Region. fast_matching giảm kích thước cả ảnh Region và template.

Bộ điều khiển tĩnh cho chụp màn hình dùng chung trong lần chạy macro hiện tại. Cache tự động thường dùng lại frame trong tối đa 100 ms để giảm công việc chụp. Khi cần nhận diện liên tục với frame mới nhất hiện có, dùng auto_cache_off(); việc này tăng xử lý và hao pin, không bảo đảm chạy nhanh hơn hoặc có pixel vừa được vẽ mới. cache_on() ghim riêng một frame và được ưu tiên hơn thiết lập cache tự động.

Kho key/value bền vững dạng static cho macro hiện tại. Biến thường chỉ được dùng chung giữa các action PYTHON_CODE chạy tuần tự trong cùng một luồng chạy, kể cả action bên trong nhóm GROUP; các luồng chạy song song có vùng biến riêng. Key của Storage được dùng chung giữa mọi luồng chạy, vì vậy chỉ dùng Storage khi giá trị cần tồn tại sang lần chạy macro tiếp theo, không dùng như kênh nhắn tin liên tiến trình. Các thay đổi được tự lưu sau 2 giây không có lượt ghi mới và được commit lại sau khi toàn bộ lượt Run cùng mọi luồng chạy nền kết thúc.

Một điểm trong đường vuốt phẳng. Point phải là Point hoặc tuple (x, y). Truyền list có ít nhất hai SwipePoint vào swipe([...]) để một ngón đi qua nhiều điểm.

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

Lớp bọc ảnh template. Bạn có thể scale/crop một template có sẵn, lưu thành tên mới, hoặc kiểm tra tồn tại.

Đối tượng model TFLite để dùng trong script. Kiểu model phải được chọn trong metadata của Template Manager. Các đầu ra đang hỗ trợ gồm 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], và MobileNetV3 image classification [1,C]. Runtime tự đọc precision FLOAT32, INT8 hoặc UINT8 từ model và giải lượng tử output detection/classification trước khi áp dụng threshold. Kết quả classification trả confidence và metadata theo class, không dựng point hoặc bounds giả. Các hàm inference yêu cầu file model cục bộ; nếu thiếu file local và runtime tải lại thất bại thì script sẽ báo lỗi runtime.

Đồng hồ bấm giờ theo millisecond dùng để kiểm tra thời lượng và chờ có điều kiện trong script.

Helper tĩnh cho các click/swipe chạy song song được tạo bởi UI hoặc code click(..., parallel=True), swipe(..., parallel=True). Bạn có thể gom các click/swipe lại rồi gửi một lượt, hoặc lấy thông tin về các click/swipe đang nhấn/đang chờ. Helper cũng cung cấp khả năng huỷ click/swipe đang hoạt động (chỉ hoạt động đối với Android 8.0+).

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.

Bộ điều khiển static để khởi chạy song song các luồng chạy có tên của macro. Tối đa hai luồng chạy nền có thể chạy cùng luồng chạy chính và mỗi tên chỉ được có một lượt gọi còn sống, kể cả khi đang tạm dừng hoặc đang dừng. Flow.start() trả về ngay sau khi bộ điều phối chấp nhận nhánh; luồng chạy nền có thể khởi chạy luồng ngang hàng. Biến được tách riêng theo từng nhánh và không bao giờ hợp nhất về nhánh gọi. Luồng chạy chính chờ mọi luồng chạy nền trước khi lượt Run hoàn tất. Tên không hợp lệ hoặc trùng, hết chỗ chạy nền, lỗi ở bất kỳ nhánh nào, System.stop() hoặc nút Stop của Main đều kết thúc toàn bộ macro. Mỗi điều khiển dock có số của luồng chạy nền chỉ có thể tạm Pause hoặc Resume riêng nhánh đó; không có Stop riêng từng nhánh. Pause hoặc Resume của Main áp dụng cho mọi nhánh, và Resume toàn cục cũng xóa cờ pause cục bộ của nhánh. Cử chỉ chạm từ các nhánh khác nhau có thể hủy lẫn nhau. Chính sách ScreenCapture và audio capture được dùng chung toàn cục. Storage dùng chung các key bền vững giữa các nhánh và không phải kênh nhắn tin liên tiến trình.

Kết quả nhận diện dạng chỉ đọc, được trả về từ các hàm region.find*. Trong nhánh Thành công của nhận diện, Recognition.result trỏ tới Match hoặc MatchList nhận diện hiện tại.

Một list chỉ đọc gồm các giá trị Match, được trả về từ region.find_any/find_all/find_multi, wait_any/wait_all và Recognition.result khi nhiều mục tiêu nhận diện cùng khớp.

Đượ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.

Ảnh chụp trạng thái của một touch script/UI trong hàng đợi gesture dùng chung.

Tập hợp key/value giữ thứ tự thêm vào và có thể đọc hoặc cập nhật khi kịch bản đang chạy.

Danh sách có thứ tự. Dùng khi bạn cần các giá trị có thể đếm, đọc theo vị trí, bung giá trị, hoặc lặp qua theo đúng thứ tự.

Collection có thể cập nhật và chỉ giữ các giá trị không trùng nhau. CogniTab giữ thứ tự lặp ổn định để output script dễ đọc.

Collection kiểu văn bản. Tạo bằng string literal hoặc str(value), rồi đọc bằng len/index/vòng lặp.

Collection có thứ tự và chỉ đọc. Dùng tuple literal khi dữ liệu không cần thay đổi sau khi tạo hoặc khi gom giá trị để bung vào nhiều biến.