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.

🎨 Hình ảnh

Tự động tìm màu trên màn hình trong RunMacro

Multi Color dò các mã màu trong vùng màn hình, áp dụng dung sai và xử lý theo kết quả tìm thấy.

Điều kiện cần#

  • Đã biết mã màu hoặc có mẫu màu cần dò.
  • Vùng màn hình mục tiêu đã hiển thị.

Chế độ hỗ trợ#

  • Chế độ Desktop
  • Chế độ Browser — Chạy nền qua Chrome CDP: RunMacro chụp ảnh trang rồi dò màu trên ảnh đó, nên chỉ thấy nội dung bên trong trang chứ không thấy phần còn lại của màn hình. Vùng dò được quy đổi từ tọa độ CSS sang pixel ảnh chụp.

Chức năng này làm gì#

Lệnh Multi Color dò trên màn hình xem có điểm ảnh mang mã màu bạn chỉ định (một hoặc nhiều màu) hay không. Nếu thấy, RunMacro có thể di chuột/click tới đó hoặc rẽ nhánh — hữu ích khi trạng thái được thể hiện bằng màu.

Hình ảnh & video#

Giao diện cấu hình các trường thông số của lệnh Multi Color trong RunMacro
Khung cấu hình các trường thông số của lệnh Multi Color trong RunMacro.

Khi nào nên dùng#

  • Nhận biết trạng thái qua màu (đèn xanh = sẵn sàng, đỏ = lỗi).
  • Tìm nút/thanh có màu đặc trưng.
  • Kiểm tra một vùng có đổi màu hay chưa rồi mới thao tác.
  • Tự động hóa game dựa trên màu (máu, mana...).

Khi nào không nên dùng#

  • Màu thay đổi mạnh theo theme hoặc độ sáng mà không thể đặt dung sai phù hợp.
  • Cần xác định phần tử theo cấu trúc HTML.

Các bước cấu hình#

  1. Thêm lệnh Hình ảnh › Multi Color.
  2. Nhập một hoặc nhiều mã màu hex (vd #FF0000). Tối đa 10 màu.
  3. Chỉnh dung sai để chấp nhận sắc độ gần đúng.
  4. (Tùy chọn) khoanh vùng để dò nhanh hơn.
  5. Chọn hành động khi thấy và đặt nhãn IF/ELSE. Lưu.

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

Mã màu (một hoặc nhiều, hex)#

Danh sách màu cần dò, dạng #RRGGBB. Tìm thấy bất kỳ màu nào là tính khớp. Tối đa 10 màu.

Chế độ chờ (Wait Mode)#

Chờ xuất hiện (Appear): đợi màu xuất hiện trên màn hình; Chờ biến mất (Vanish): đợi màu biến mất.

Dung sai (tolerance)#

Mức chênh màu cho phép. Lớn = bắt được nhiều sắc độ gần đúng; nhỏ = phải khớp sát.

Vùng tìm kiếm (region)#

Giới hạn khu vực dò màu. Bỏ trống = toàn màn hình.

Hành động khi thấy#

Không làm gì, di chuột tới, click, double click, hoặc click phải tại điểm màu tìm được.

Số lần thử + Chờ giữa các lần (ms) / Timeout#

Dò lại cho tới khi màu xuất hiện/biến mất hoặc hết timeout (mặc định 25 lần x 200ms = 5 giây timeout).

Nhãn IF / Nhãn ELSE#

Thấy màu thì nhảy IF; hết lần thử không thấy thì nhảy ELSE.

Kết quả mong đợi#

Lệnh báo màu có khớp hay không và thực hiện hành động hoặc nhánh IF/ELSE đã chọn.

Ví dụ thực tế#

Ví dụ: Chờ đèn xanh rồi tiếp tục#

  1. Lấy mã màu xanh của đèn trạng thái (vd #22C55E).
  2. Thêm Multi Color, nhập mã màu, dung sai vừa phải.
  3. Hành động không làm gì, nhãn IF = san_sang.
  4. Đặt các bước tiếp theo dưới nhãn san_sang.

Giới hạn và trường hợp lỗi#

  • Màu hiển thị có thể lệch do theme, độ sáng hoặc hiệu ứng.
  • Quét vùng lớn và nhiều màu có thể tốn thêm thời gian.

Mẹo & lỗi thường gặp#

Lấy mã màu chính xác bằng công cụ hút màu (color picker) trước, rồi dán vào lệnh.
Màu trên màn hình có thể lệch do theme/độ sáng — tăng nhẹ dung sai nếu hay trượt.

Thông tin kiểm chứng#

  • commands/capture.py
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.