key: image.image_click
nhóm: ImageAction
hàm Client A13: image_click
Tìm ảnh mẫu trên màn hình rồi click vào đó. Dùng khi phần tử không có DOM ổn định để bám (canvas, ảnh, popup native, iframe chéo miền).
| 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ủ. |
| Button | button |
options (left / middle / right) | left |
Chức năng: Nút chuột dùng cho thao tác này. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: left. Giải nghĩa: Bấm chuột trái — thao tác thông thường. Ví dụ 2: right. Giải nghĩa: Bấm chuột phải để mở menu ngữ cảnh. Ví dụ 3: middle. Giải nghĩa: Bấm chuột giữa, thường để mở link trong tab mới. |
| Clicks | clicks |
string | 1 |
Chức năng: Số lần bấm liên tiếp tại cùng một điểm. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: 1. Giải nghĩa: Bấm một lần như thao tác thường. Ví dụ 2: 2. Giải nghĩa: Bấm đúp để mở file hoặc bôi đen một từ. Ví dụ 3: 3. Giải nghĩa: Bấm ba lần để bôi đen cả dòng/đoạn văn. |
🚩 = 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.
{
"version": "great-lotus-pyauto-v1",
"action": {
"key": "image.image_click",
"group": "ImageAction",
"function": "image_click"
},
"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
},
"button": {
"type": "options",
"value": "left"
},
"clicks": {
"type": "string",
"value": 1
}
},
"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.