ImageWait

key: image.image_wait nhóm: ImageAction hàm Client A13: image_wait

Chức năng

Chờ tới khi ảnh mẫu XUẤT HIỆN trên màn hình hoặc hết timeout. Dùng làm chốt đồng bộ khi không có DOM để chờ.

Tham số (4)

Tên trên UI	payloadName	Kiểu	Mặc định	Mô tả
🚩 Image URL	`image_url`	string	`—`	Chức năng: Ảnh mẫu mà Client sẽ dò tìm trên màn hình. Nhận link http(s) để tải về, hoặc đường dẫn file có sẵn trên máy Client. Bạn cần nhập mục này để action chạy đúng. Ví dụ 1: C:/images/login_button.png. Giải nghĩa: Dùng ảnh đã lưu sẵn trên máy Client — nhanh nhất. Ví dụ 2: http://lotus1104.synology.me:81/share/01_Store/UID_000123.png. Giải nghĩa: Tải ảnh mẫu từ NAS về rồi tìm. Ví dụ 3: ={{$json.image_url}}. Giải nghĩa: Ảnh mẫu do bước trước chọn ra.
Temperature	`temperature`	string	`0.7`	Chức năng: Độ giống nhau tối thiểu giữa ảnh mẫu và vùng trên màn hình, từ 0.01 đến 1. Càng gần 1 càng khắt khe, giảm nhận nhầm nhưng dễ trượt khi màn hình đổi độ sáng hoặc tỉ lệ. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: 0.7. Giải nghĩa: Mức mặc định, dễ tìm thấy kể cả khi ảnh hơi khác. Ví dụ 2: 0.85. Giải nghĩa: Khắt khe hơn, hợp khi trên màn hình có nhiều thứ na ná nhau. Ví dụ 3: 0.95. Giải nghĩa: Gần như phải giống hệt — chỉ dùng khi ảnh mẫu chụp từ chính máy đó.
Interval (sec)	`interval_sec`	string	`0.1`	Chức năng: Nhịp kiểm tra lại điều kiện, tính bằng giây. Số nhỏ thì phát hiện nhanh nhưng tốn CPU của máy Client. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: 0.1. Giải nghĩa: Kiểm tra 10 lần mỗi giây — phản ứng gần như tức thời. Ví dụ 2: 1. Giải nghĩa: Mỗi giây một lần, đủ dùng cho hầu hết trường hợp. Ví dụ 3: 3. Giải nghĩa: Thưa hẳn, dùng khi chờ tác vụ dài và không cần nhạy.
Timeout (sec)	`timeout_sec`	string	`60`	Chức năng: Thời gian chờ tối đa tính bằng giây trước khi báo lỗi. Đặt quá ngắn thì workflow gãy oan khi mạng chậm; quá dài thì lỗi thật cũng phải đợi lâu mới biết. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: 5. Giải nghĩa: Thao tác nhanh trên trang nội bộ. Ví dụ 2: 30. Giải nghĩa: Mức cân bằng cho phần lớn trang web công cộng. Ví dụ 3: 120. Giải nghĩa: Trang nặng hoặc thao tác phải chờ xử lý phía máy chủ.

🚩 = bắt buộc. Ô rỗng của tham số tùy chọn sẽ bị loại khỏi payload.inputs — Client tự áp default.

Payload MQTT gửi đi

{
  "version": "great-lotus-pyauto-v1",
  "action": {
    "key": "image.image_wait",
    "group": "ImageAction",
    "function": "image_wait"
  },
  "inputs": {
    "image_url": {
      "type": "string",
      "value": ""
    },
    "temperature": {
      "type": "string",
      "value": 0.7
    },
    "interval_sec": {
      "type": "string",
      "value": 0.1
    },
    "timeout_sec": {
      "type": "string",
      "value": 60
    }
  },
  "meta": {
    "requestId": "<16 hex>",
    "requestTopic": "WP2_PC176",
    "responseTopic": "RES_WP2_PC176",
    "waitForResponse": true,
    "responseTimeoutSec": 60
  }
}

Publish lên topic bạn nhập ở ô Topic; nếu bật Wait For Response, node chờ Client trả lời trên RES_<topic> với đúng meta.requestId. return: "NG" ⇒ node ném lỗi.

Sinh tự động bởi tools/gen_doc_html.js từ ACTION_SPECS (package n8n-nodes-c12_pyautogui_web@0.1.34) · 2026-07-22 · Đừng sửa tay file này — sửa _notes/ hoặc source rồi chạy lại npm run doc:build.