Hỗ trợ thủ công
LCC.assist cho phép tập lệnh trên thiết bị gửi yêu cầu hỗ trợ thủ công tới trung tâm điều khiển. Tập lệnh có thể đính kèm ảnh chụp màn hình và nội dung hướng dẫn, chặn để chờ người vận hành gửi kết quả rồi mới tiếp tục thực thi.
Loại yêu cầu
| Loại | API | Trường hợp phù hợp | Cách xử lý thông thường của script |
|---|---|---|---|
| Phản hồi văn bản | LCC.assist.ask_text() | Mã xác minh, mã SMS, mật khẩu, mã dùng một lần | Nhập result.text vào ô nhập hiện tại |
| Chọn tọa độ | LCC.assist.pick_point() | Cần người vận hành xác định vị trí cần chạm, chẳng hạn nút đồ họa hoặc nút trong hộp thoại lỗi | Gọi trực tiếp touch.tap(result.x, result.y) |
| Điều khiển từ xa thủ công | LCC.assist.request_control() | Các quy trình không ổn định như thanh trượt, CAPTCHA, đăng nhập, kiểm tra bảo mật hoặc hộp thoại quyền | Chờ điều khiển từ xa hoàn tất, sau đó chụp lại màn hình để tiếp tục nhận diện |
Nội dung hướng dẫn cho người vận hành phải cụ thể và có thể thực hiện ngay; không nên dùng mô tả mơ hồ như “thông tin bổ sung”. Nên viết rõ như “Hãy điều khiển từ xa để hoàn tất xác minh rồi nhấp Hoàn tất”, “Hãy nhập mã xác minh trong ảnh chụp màn hình” hoặc “Hãy chọn tâm nút xác nhận”.
Nguồn ảnh chụp màn hình
Yêu cầu hỗ trợ có thể kèm theo hình ảnh theo nhiều cách khác nhau:
screenshotLocalPath: Đường dẫn ảnh cục bộ trên thiết bị; SDK tải ảnh lên thành tài nguyên tạm thời trên trung tâm.screenshotPath: Khi hình ảnh đã nằm trong thư mục gốcfilestrên máy chủ, chỉ cần truyền đường dẫn tương đối.screenshotImage: XXTouchImageObject, SDK sẽ chuyển đổi nó thành data URL, không cần lưu trước vào tập tin.screenshotImageData: Dữ liệu nhị phân của hình ảnh dạng PNG/JPEG, SDK sẽ chuyển đổi nó thành data URL.input.imageSrc: Nếu tập lệnh đã có địa chỉ ảnh dạngdata:image/...,http(s)://...hoặc/api/..., có thể đặt địa chỉ đó tronginputđể chuyển nguyên trạng cho giao diện hiển thị.
input.imageSrc sẽ không bị SDK ghi đè. Chỉ khi không truyền input.imageSrc và cũng không truyền ảnh chụp màn hình theo đường dẫn, thì SDK mới chuyển đổi screenshotImage hoặc screenshotImageData thành input.imageSrc.
Vòng đời
Các trạng thái yêu cầu gồm pending (chờ xử lý), active (đang xử lý), submitted (đã gửi kết quả), cancelled (đã hủy) và expired (đã hết hạn). Chỉ submitted cho biết đã có kết quả do người dùng cung cấp.
Khi LCC.assist.request() hết thời gian chờ, SDK thử hủy yêu cầu đó. Khi tập lệnh kết thúc bình thường, SDK thử hủy các yêu cầu chưa hoàn tất của phiên hiện tại. Tác vụ và kết quả không được giữ lại sau khi trung tâm khởi động lại; hãy lưu riêng kết quả cần dùng lâu dài.
Khi nhận trạng thái thiết bị đã dừng, trung tâm hủy các yêu cầu trợ giúp lua-script của thiết bị đó còn ở trạng thái pending / active. Việc hủy hàng loạt này không ảnh hưởng thiết bị khác, nguồn khác hoặc kết quả đã gửi.
Ảnh chụp được tải lên tự động sẽ bị dọn dẹp khi trung tâm khởi động. Muốn dùng lâu dài, hãy lưu bản sao vào đường dẫn tài nguyên do bạn quản lý; không coi screenshotPath tự sinh là tham chiếu tệp vĩnh viễn.
Ảnh nội tuyến không được giữ lại sau khi yêu cầu được gửi kết quả, bị hủy hoặc hết hạn.
Danh sách API
- Tham số chung và đối tượng trả về
- Tạo yêu cầu hỗ trợ thủ công
LCC.assist.create() - Chờ kết quả hỗ trợ thủ công
LCC.assist.wait() - Tạo và chờ yêu cầu
LCC.assist.request() - Yêu cầu trả lời bằng văn bản
LCC.assist.ask_text() - Yêu cầu chọn tọa độ
LCC.assist.pick_point() - Yêu cầu điều khiển từ xa thủ công
LCC.assist.request_control() - Hủy yêu cầu cụ thể
LCC.assist.cancel() - Hủy yêu cầu script hiện tại
LCC.assist.cancel_all()