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 Tìm kiếm Hình ảnh
🖼 Hình ảnh

Tự động click theo hình ảnh trong RunMacro

Tìm Ảnh dò mẫu hình ảnh trong vùng màn hình, thử lại theo cấu hình và thực hiện hành động khi tìm thấy.

Điều kiện cần#

  • Có ảnh mẫu rõ và phù hợp với giao diện cần dò.
  • Màn hình hoặc tab Trình duyệt mục tiêu đã sẵn sàng.

Chế độ hỗ trợ#

  • Chế độ Desktop
  • Chế độ Browser

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

Lệnh Tìm kiếm Hình ảnh chụp màn hình rồi dò xem một ảnh mẫu (nút, biểu tượng...) có xuất hiện không. Nếu thấy, RunMacro có thể di chuột tới đó, click, hoặc rẽ nhánh theo kết quả. Đây là cách bấm ổn định khi vị trí phần tử hay thay đổi.

Hình ảnh & video#

Giao diện cấu hình các trường thông số của lệnh Tìm kiếm Hình ảnh trong RunMacro
Khung cấu hình các trường thông số của lệnh Tìm kiếm Hình ảnh trong RunMacro.

Khi nào nên dùng#

  • Nút/biểu tượng hay đổi vị trí nên không click theo tọa độ cố định được.
  • Chờ một hình xuất hiện rồi mới thao tác (vd nút "Tiếp tục" hiện lên).
  • Rẽ nhánh: nếu thấy ảnh thì làm A, không thấy thì làm B.
  • Tự động hóa game/ứng dụng không có selector.

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

  • Giao diện có selector HTML ổn định và cần định vị theo DOM.
  • Ảnh mẫu thay đổi đáng kể giữa các lần chạy.

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

  1. Thêm lệnh Hình ảnh › Tìm kiếm Hình ảnh.
  2. Thêm một hoặc nhiều ảnh mẫu (cắt ảnh nút/biểu tượng cần tìm).
  3. (Tùy chọn) khoanh vùng tìm kiếm để tìm nhanh và chính xác hơn.
  4. Chọn hành động khi thấy: không làm gì / di chuột / click / click phải.
  5. Đặt số lần thử và thời gian chờ giữa các lần nếu ảnh xuất hiện chậm.
  6. Đặt nhãn IF/ELSE để rẽ nhánh. Lưu.

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

Ảnh mẫu (một hoặc nhiều)#

Các ảnh cần dò trên màn hình. Có thể thêm nhiều ảnh; chỉ cần khớp một là coi như thấy.

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

Giới hạn khu vực dò để nhanh và tránh nhầm. Bỏ trống = tìm toàn màn hình.

Hành động khi thấy#

Không làm gì (chỉ kiểm tra), di chuột tới, click, double click, hoặc click phải tại tâm ảnh.

Độ tương đồng (confidence)#

Mức khớp tối thiểu (vd 0.9). Cao = chặt, dễ trượt; thấp = dễ khớp nhầm.

Khoảng phóng đại (scale min/max)#

Cho phép ảnh mẫu to/nhỏ hơn một chút vẫn khớp — hữu ích khi độ phân giải khác nhau.

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

Dò lại nhiều lần cho tới khi ảnh xuất hiện. Dùng khi phần tử tải chậm.

Nhãn IF / Nhãn ELSE#

Thấy ảnh thì nhảy tới nhãn IF; hết số lần thử mà không thấy thì nhảy ELSE.

Rung khi click + Trễ vi mô#

Thêm dao động/độ trễ nhỏ khi click cho giống người thật (khi hành động là click).

Tab đích ở Chế độ Browser (tiêu đề/URL)#

Ở Chế độ Trình duyệt, chỉ định tab Chrome cần chụp để tìm ảnh theo tiêu đề hoặc URL.

Kết quả mong đợi#

RunMacro trả về kết quả tìm thấy hoặc không tìm thấy và thực hiện nhánh/hành động tương ứng.

Ví dụ thực tế#

Ví dụ: Chờ nút "Tải xuống" rồi bấm#

  1. Cắt ảnh nút "Tải xuống" làm ảnh mẫu.
  2. Thêm Tìm kiếm Hình ảnh, chọn hành động click.
  3. Đặt số lần thử 25, chờ 200ms mỗi lần.
  4. Nhãn ELSE trỏ tới bước xử lý khi không thấy nút.

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

  • Độ phân giải, DPI, theme và chất lượng ảnh ảnh hưởng kết quả khớp.
  • Tìm kiếm toàn màn hình có thể chậm hơn vùng giới hạn.

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

Cắt ảnh mẫu gọn, chỉ lấy phần đặc trưng (biểu tượng/chữ) — tránh nền dễ thay đổi để khớp ổn định hơn.
Khoanh vùng tìm kiếm để dò nhanh hơn nhiều và giảm khớp nhầm.
Nếu confidence quá cao mà đổi độ phân giải/theme, ảnh có thể không khớp — nới nhẹ confidence hoặc dùng khoảng phóng đại.

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.