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.

🔔 Gỡ lỗi

Phát tiếng bíp báo hiệu trong RunMacro

Beep thử phát một âm Windows theo tần số và thời lượng đã đặt; nếu phát âm lỗi, RunMacro bỏ qua lỗi và vẫn chạy bước tiếp theo.

Điều kiện cần#

  • Workflow đang chạy trên Windows.
  • Máy đích có đầu ra âm thanh đang bật nếu bạn cần nghe tín hiệu.
  • Đã chọn tần số và thời lượng phù hợp rồi chạy thử.

Chế độ hỗ trợ#

  • RunMacro Runner

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

Lệnh Beep gọi trực tiếp winsound.Beep của Windows để phát một âm báo với tần số (Hz) và thời lượng (ms) bạn đặt. Đây là tín hiệu âm thanh best-effort: nếu Windows từ chối giá trị hoặc thiết bị không phát được âm, RunMacro bắt lỗi, không hiện lỗi và vẫn chuyển sang bước kế tiếp.

Hình ảnh & video#

Giao diện cấu hình các trường thông số của lệnh Beep (Bíp) trong RunMacro
Khung cấu hình các trường thông số của lệnh Beep (Bíp) trong RunMacro.

Khi nào nên dùng#

  • Báo bằng âm thanh khi workflow đi tới cuối hoặc một mốc quan trọng.
  • Nhắc bạn quay lại máy khi một bước chờ thủ công sắp bắt đầu.
  • Phân biệt các nhánh bằng những tần số hoặc thời lượng khác nhau.
  • Thêm tín hiệu phụ bên cạnh Log Message hoặc thông báo có thể kiểm chứng.

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

  • Không dùng Beep làm bằng chứng rằng tác vụ đã thành công hoặc một người đã nhận thông báo.
  • Không dùng khi workflow chạy trên máy không có đầu ra âm thanh hoặc cần dữ liệu có cấu trúc cho hệ thống khác.

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

  1. Thêm lệnh Gỡ lỗi › Beep tại vị trí cần báo.
  2. Đặt tần số (Hz) để chọn cao độ.
  3. Đặt thời lượng (ms) để chọn độ dài âm.
  4. Chạy thử một workflow ngắn trên đúng máy sẽ sử dụng để xác nhận âm có nghe được.
  5. Lưu workflow; khi tới lệnh, RunMacro thử phát âm rồi luôn tiếp tục bước sau.

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

Tần số (freq, Hz)#

Giá trị được truyền cho Windows để quyết định cao độ; số lớn hơn tạo âm cao hơn khi thiết bị hỗ trợ.

Thời lượng (duration, ms)#

Số mili-giây được truyền cho Windows để giữ âm; thời lượng dài hơn làm workflow chờ lâu hơn tại bước này.

Kết quả mong đợi#

RunMacro yêu cầu Windows phát âm báo, chờ hết thời lượng nếu phát được, rồi tiếp tục. Nếu Windows báo lỗi, lệnh vẫn kết thúc thành công và workflow tiếp tục mà không có âm.

Ví dụ thực tế#

Ví dụ: Bíp khi hoàn thành#

  1. Đặt Beep ở cuối workflow với 1000Hz và 500ms.
  2. Thêm Log Message "Đã hoàn thành" ngay trước hoặc sau Beep.
  3. Nếu máy phát được âm, bạn nghe tiếng bíp; dù không nghe thấy, workflow vẫn kết thúc bình thường và log vẫn là bằng chứng.

Ví dụ: Hai âm cho hai nhánh#

  1. Dùng một Beep ngắn ở nhánh thành công và một Beep dài hơn ở nhánh cần kiểm tra.
  2. Chạy thử cả hai nhánh trên máy đích trước khi phụ thuộc vào tín hiệu.

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

  • Không đảm bảo âm sẽ phát hoặc được nghe; lỗi phát âm không được ghi log.
  • Âm lượng phụ thuộc cấu hình Windows và thiết bị, còn thời lượng làm chậm luồng tương ứng.
  • Lệnh không trả về dữ liệu và không xác nhận người dùng đã chú ý.

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

Âm được phát qua cơ chế âm thanh của Windows; loa bị tắt, âm lượng thấp hoặc thiết bị không hỗ trợ có thể khiến bạn không nghe thấy.
Beep nuốt lỗi phát âm và vẫn trả về thành công. Không nghe thấy tiếng bíp không làm workflow dừng và cũng không tạo log lỗi.
Khi cần bằng chứng hoặc người nhận xác nhận, dùng Log Message, file kết quả hay thông báo Telegram; Beep chỉ nên là tín hiệu phụ.

Thông tin kiểm chứng#

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