Tài liệu

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.

Tài liệu Hình ảnh Chờ màu điểm ảnh (Wait Pixel)
🎨 Hình ảnh

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#

Giao diện cấu hình các trường thông số của lệnh Chờ màu điểm ảnh (Wait Pixel) trong RunMacro
Khung cấu hình các trường thông số của lệnh Chờ màu điểm ảnh (Wait Pixel) trong RunMacro.

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#

  1. Trong RunMacro, chọn nhóm Hình ảnh › Chờ màu điểm ảnh (Wait Pixel).
  2. 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.
  3. 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).
  4. Nhập Thời gian chờ tối đa (Timeout ms) (ví dụ 5000ms hoặc 10000ms).
  5. Bấm Lưu.

Giải thích từng tùy chọn#

Tọa độ X, Y (Coordinates)#

Tọa độ pixel tuyệt đối trên màn hình hiển thị cần theo dõi màu sắc.

Mã màu RGB (Red, Green, Blue)#

Giá trị ba kênh màu: R (Đỏ 0–255), G (Lục 0–255), B (Lam 0–255) của điểm ảnh mục tiêu.

Dung sai màu sắc (Tolerance)#

Độ lệch màu tối đa cho phép trên mỗi kênh R, G, B (từ 0 đến 50, mặc định 10) giúp nhận diện ổn định khi màn hình có hiệu ứng làm mịn hoặc đổi nền mờ.

Thời gian chờ tối đa (Timeout ms)#

Thời gian tối đa (mili-giây) RunMacro chờ điểm ảnh đổi màu trước khi tiếp tục hoặc báo timeout (mặc định 5000ms).

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

  1. 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ị.
  2. Bấm Lấy tọa độ & màu nhấp vào vị trí bóng đèn tín hiệu.
  3. Điền RGB là (34, 197, 94), đặt Tolerance là 15, Timeout là 8000ms.
  4. 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#

Đặt dung sai Tolerance = 15 là lý tưởng cho hầu hết ứng dụng trên Windows vì hệ điều hành có thể khử răng cưa (ClearType) khiến màu mép hơi biến thiên.
Đảm bảo cửa sổ mục tiêu không bị che khuất bởi cửa sổ khác trong suốt quá trình theo dõi điểm ảnh màn hình.

Thông tin kiểm chứng#

  • commands/wait.py · xác minh 2026-09-30
Robot biểu tượng của RunMacro

Công việc của robot. Thời gian của bạn.

Tạo robot trong vài phút, không cần lập trình. Chạy ổn định, quản lý từ xa, chi phí rõ ràng — và bạn luôn giữ quyền kiểm soát.