Zoom (Thu phóng)
Chụm hai ngón để phóng to hoặc thu nhỏ màn hình.
Mục đích
Gửi cú chụm hai ngón neo ở tâm màn hình để phóng to (hai ngón tách ra) hoặc thu nhỏ (hai ngón chụm lại). Dùng trên bản đồ, ảnh, hay bất kỳ khung nhìn chụm-để-zoom nào.
Mức zoom độc lập độ phân giải, nên cùng thiết lập hành xử y hệt trên mọi cỡ màn.
Khi nào dùng
- Thu nhỏ bản đồ để thấy nhiều hơn trước khi quét.
- Phóng to để mục tiêu nhỏ đủ lớn cho phát hiện hoặc đọc ổn định.
- Đưa khung nhìn về mức zoom đã biết ở đầu flow.
Khi nào không dùng
- Zoom một góc cụ thể. Cú chụm luôn neo giữa. Pan trước bằng Swipe, rồi zoom.
- Trên khung nhìn không hỗ trợ chụm-zoom — cử chỉ vẫn được gửi và vẫn báo Success.
Điều kiện
Thiết bị nhận multi-touch. Không cần node phía trên.
Cách nó chạy
- Mode chọn chiều — Zoom in tách ngón, Zoom out chụm ngón.
- Tính khoảng cách đầu/cuối của hai ngón quanh tâm màn từ Zoom factor — một tỉ lệ span, nên 200% nghĩa là span xa gấp đôi span gần trên mọi độ phân giải.
- Gửi cử chỉ hai ngón neo giữa trong khoảng thời gian ngắn cố định, rồi rẽ Success.
Flow cũ có thể mang strength theo pixel; giá trị đó chỉ dùng cho các flow cũ ấy.
Thiết lập
| Thiết lập | Kiểu | Khoảng | Mặc định | Tác dụng |
|---|---|---|---|---|
| Mode | lựa chọn | zoomIn, zoomOut | — | Bắt buộc. Ngón tách ra, hay chụm vào |
| Zoom factor | number | 110–500 % | — | Zoom bao xa. Tỉ lệ span độc lập độ phân giải (200 = 2×) |
| Strength (px) | integer | 1–2000 | — | Di sản. Hành trình pixel mỗi ngón; chỉ nhận từ flow cũ |
| Wait after | integer | 0–60000 ms | — | Nghỉ sau cử chỉ |
Phải có đúng một trong Zoom factor hoặc Strength cũ.
Vì sao tối thiểu 110%
Hệ số là tỉ lệ phóng đại, không phải lượng có dấu. Giá trị dưới 110% bị từ chối vì "zoom in 90%" vô nghĩa — muốn thu nhỏ, đặt Mode Zoom out và giữ hệ số trên 110.
Cử chỉ luôn neo giữa
Không neo được cú chụm nơi khác. Muốn zoom một khu vực, đưa nó về giữa trước — Swipe chế độ Bring a target to the centre làm chính xác việc đó.
Port
| Port | Đi vào khi | Bắt buộc |
|---|---|---|
| Success | Cú chụm được gửi | Không — port này tùy chọn |
| Failure | Không gửi được cử chỉ | Không |
| Timeout | Lệnh input không hoàn tất kịp | Không |
| Cancelled | Lần chạy dừng giữa cử chỉ | Không — không bao giờ được đi |
| Fatal | Mất kết nối, hoặc mode/hệ số sai | Không — không bao giờ được đi |
Zoom bất thường: không có port bắt buộc. Zoom có Success bỏ trống đơn giản kết thúc nhánh đó.
Ví dụ cơ bản
Phóng bản đồ lên gấp đôi span:
- Mode: Zoom in
- Zoom factor:
200%
Ví dụ thực tế — chuẩn hóa khung nhìn
Automation bản đồ đáng tin hơn nhiều khi mọi lần chạy khởi đầu từ cùng mức zoom. Một flow "reset khung nhìn" ngắn:
Thu hết cỡ rồi phóng lại một lượng đã biết đạt mức zoom lặp lại được bất kể khung nhìn khởi đầu ở đâu — chính điều làm template ở các bước sau khớp.
Ví dụ nâng cao — đóng khung mục tiêu chính xác
Căn giữa rồi phóng to làm chữ nhỏ trên màn đủ lớn cho OCR đọc chính xác — thường là khác biệt giữa tỉ lệ đọc 60% và 99%.
Best practices
- Pan trước, zoom sau. Cú chụm neo giữa, n ên việc đóng khung là của Swipe.
- Luôn ổn định sau zoom. Khung bản đồ có hiệu ứng; phát hiện ngay sau đọc hiệu ứng.
- Chuẩn hóa zoom ở đầu flow thay vì cho rằng lần chạy trước để nó ở chỗ hợp lý.
- Phóng to trước OCR trên chữ nhỏ. Độ chính xác OCR phụ thuộc mạnh vào cỡ glyph.
- Nối Success dù tùy chọn — port bỏ trống lặng lẽ kết thúc nhánh.
Ghi chú hiệu năng
- Thời gian cử chỉ cố định bởi runtime và ngắn. Chi phí thật là thời gian ổn định bạn thêm sau.
- Phóng to làm so khớp template rẻ hơn nếu bạn cũng thu hẹp vùng tìm, và đắt hơn nếu không — mục tiêu to hơn trên phép tìm toàn màn vẫn quét cả khung.
- Chu kỳ zoom out/in lặp lại để "reset" tốn hai cử chỉ cộng hai lần ổn định. Làm một lần đầu flow, đừng trong vòng lặp.
Ghi chú bộ nhớ
- Zoom không chụp khung hình, không cache.
- Đổi zoom vô hiệu các giả định thị giác: template chụp ở mức zoom này có thể không khớp ở mức khác. Bật phát hiện đa tỉ lệ trong cổng tính năng flow, hoặc chụp template ở đúng mức zoom flow dùng.
Lỗi thường gặp
| Lỗi | Hậu quả | Cách sửa |
|---|---|---|
| Kỳ vọng zoom một góc | Cú chụm neo giữa | Vuốt mục tiêu về giữa trước |
| Đặt hệ số dưới 110 | Bị từ chối | Dùng Zoom out cho chiều ngược |
| Đọc màn ngay sau | Đọc giữa hiệu ứng | Thêm Wait |
| Template ngừng khớp sau zoom | Chụp ở tỉ lệ khác | Chụp lại, hoặc bật đa tỉ lệ |
| Vô tình bỏ trống Success | Nhánh kết thúc lặng lẽ | Nối nó |
Khắc phục sự cố
Không gì xảy ra trên màn. Khung nhìn có thể không hỗ trợ chụm-zoom. Node vẫn báo Success — nó gửi cử chỉ; không biết app có phản ứng không.
Phát hiện vỡ sau khi thêm Zoom.
Template nhạy tỉ lệ. Chụp lại ở zoom mới, hoặc bật multiScaleImageDetectionEnabled trong flow settings.
Zoom quá đà. Hạ hệ số và lặp, thay vì một cú nhảy lớn.
Node rẽ Fatal. Thiếu Mode, hoặc hệ số ngoài 110–500.
FAQ
200% có phải zoom gấp đôi? Là gấp đôi tỉ lệ span ngón tay, thứ app đích diễn giải thành cử chỉ zoom của nó. Kết quả thị giác tùy app.
Zoom tới mức chính xác được không? Không. Zoom là cử chỉ tương đối. Chuẩn hóa bằng thu hết cỡ rồi phóng một lượng đã biết.
Zoom có thiết lập duration không? Không — thời gian cử chỉ cố định bởi runtime.
Hệ số lấy từ biến được không?
Được, dạng tham chiếu {{biến}} nguyên chuỗi.
Node liên quan
- Swipe — pan mục tiêu về giữa trước
- Wait — ổn định sau cử chỉ
- Find Image — định vị thứ cần đóng khung
- Read Text — lý do thường gặp để phóng to
Trang liên quan
- Giải phẫu Flow — t ỉ lệ và chất lượng template