Tài liệu RunMacro
Tạo robot đầu tiên, rồi tiến xa theo nhu cầu.
Hướng dẫn rõ ràng từng bước để tạo, chạy và cải thiện robot cho công việc máy tính lặp lại.
Chờ màu điểm ảnh màn hình thay đổi (Wait Pixel) trong RunMacro
Wait Pixel là lệnh theo dõi giá trị màu RGB tại tọa độ điểm ảnh màn hình trong RunMacro, tiếp tục kịch bản ngay khi màu khớp với độ trễ tối thiểu và không tốn CPU.
Điều kiện cần#
- Tọa độ pixel hiển thị rõ ràng trên màn hình và không bị cửa sổ khác che lấp.
Chế độ hỗ trợ#
- Chế độ Desktop — Đo màu pixel 1x1 qua Windows GDI screenshot với tốc độ siêu nhanh.
Chức năng này làm gì#
Lệnh Chờ màu điểm ảnh (Wait Pixel) theo dõi liên tục giá trị màu sắc RGB (Đỏ, Lục, Lam) tại một tọa độ pixel (X, Y) xác định trên màn hình và cho phép kịch bản tiếp tục thực thi ngay khi màu tại điểm đó trùng khớp với mã màu chỉ định (kèm dung sai Tolerance cho phép). Phương pháp nhận diện bằng pixel có tốc độ lấy mẫu cực cao (hàng chục lần mỗi giây) với mức tiêu thụ CPU gần như bằng 0, là giải pháp lý tưởng để nhận biết trạng thái đèn báo, nút đổi màu khi xử lý xong hoặc tín hiệu hoàn tất trên các ứng dụng đồ họa canvas không hỗ trợ UIA.
Hình ảnh & video#

Khi nào nên dùng#
- Chờ đèn trạng thái kết nối chuyển từ màu đỏ sang màu xanh lá cây trong các phần mềm điều khiển thiết bị hoặc máy móc.
- Chờ nút bấm đổi màu sang trạng thái sẵn sàng (Active) sau khi hệ thống xử lý xong tác vụ nền.
- Phát hiện thanh tiến trình (progress bar) hoàn tất 100% bằng cách đo màu tại điểm cuối của thanh.
- Đồng bộ hóa trong game hoặc các ứng dụng vẽ đồ họa không thể nhận diện bằng UIA hay tìm ảnh lớn.
Khi nào không nên dùng#
- Vị trí phần tử thường xuyên dịch chuyển (hãy dùng Tìm hình ảnh Find Image hoặc Smart Desktop Wait).
- Ứng dụng trình duyệt web (dùng Smart HTML Wait).
Các bước cấu hình#
- Trong RunMacro, chọn nhóm Hình ảnh › Chờ màu điểm ảnh (Wait Pixel).
- Bấm 🎯 Lấy tọa độ & màu (Pick Pixel) và nhấp vào điểm ảnh cần theo dõi trên màn hình để tự động điền X, Y và mã màu RGB.
- Thiết lập Dung sai màu sắc (Tolerance) (mặc định 10–15 để tránh lệch màu do bóng đổ hoặc độ phân giải).
- Nhập Thời gian chờ tối đa (Timeout ms) (ví dụ 5000ms hoặc 10000ms).
- Bấm Lưu.
Giải thích từng tùy chọn#
Kết quả mong đợi#
Kịch bản tiếp tục chạy ngay tại khoảnh khắc màu điểm ảnh khớp với thông số RGB đã chọn.
Ví dụ thực tế#
Ví dụ: Chờ đèn tín hiệu chuyển sang màu xanh lá RGB(34, 197, 94)#
- Thêm lệnh Chờ màu điểm ảnh (Wait Pixel) sau khi bấm nút Kết nối thiết bị.
- Bấm Lấy tọa độ & màu nhấp vào vị trí bóng đèn tín hiệu.
- Điền RGB là
(34, 197, 94), đặt Tolerance là15, Timeout là8000ms. - Khi thiết bị sẵn sàng và đèn chuyển xanh, RunMacro phát hiện tức thì và chạy ngay bước truyền dữ liệu.
Giới hạn và trường hợp lỗi#
- Nếu màn hình bật chế độ Night Light (lọc ánh sáng xanh) hoặc HDR, giá trị RGB thực tế có thể thay đổi nhẹ.
Mẹo & lỗi thường gặp#
Thông tin kiểm chứng#
commands/wait.py· xác minh 2026-09-30
RunMacro