Asistencia humana
LCC.assist permite que los scripts del dispositivo envíen solicitudes de asistencia humana al control central. El script puede adjuntar una captura y una explicación, esperar de forma bloqueante a que una persona envíe el resultado y continuar la ejecución.
Tipos de solicitud
| Tipo | API | Escenario adecuado | Tratamiento habitual del script |
|---|---|---|---|
| Respuesta de texto | LCC.assist.ask_text() | Códigos de verificación, códigos SMS, contraseñas y tokens de un solo uso | Introduce result.text en el campo de entrada actual |
| Selección de coordenadas | LCC.assist.pick_point() | Cuando una persona debe decidir dónde hacer clic, por ejemplo en un botón gráfico o de un diálogo inesperado | Llama directamente a touch.tap(result.x, result.y) |
| Control remoto manual | LCC.assist.request_control() | Controles deslizantes, verificación CAPTCHA, inicio de sesión, comprobaciones de seguridad y diálogos de permisos, entre otros flujos inestables | Espera a que termine el control remoto manual, vuelve a tomar una captura y continúa la evaluación |
Las instrucciones para el operador deben ser concretas y ejecutables; no escribas mensajes abstractos como «información adicional». Se recomienda usar frases como «Toma el control remoto, completa la verificación actual y haz clic en Completado», «Introduce el código de la captura» y «Selecciona el centro del botón de confirmación».
Fuentes de capturas de pantalla
Las solicitudes de asistencia pueden incluir imágenes de varias formas:
screenshotLocalPath: Ruta de una imagen local del dispositivo; el SDK la sube como recurso temporal al centro de control.screenshotPath: si la imagen ya está bajo la raízfilesdel control central, pasa directamente la ruta relativa.screenshotImage: objetoImageObjectde XXTouch; el SDK lo convierte en una data URL, sin necesidad de guardarlo primero en un archivo.screenshotImageData: datos binarios de imagen PNG/JPEG; el SDK los convierte en una data URL.input.imageSrc: si el script ya dispone de una dirección de imagendata:image/...,http(s)://...o/api/..., puede pasarla eninputpara mostrarla en la interfaz.
input.imageSrc no será sobrescrito por el SDK. Solo cuando no se proporciona input.imageSrc ni una captura por ruta, el SDK convierte screenshotImage o screenshotImageData en input.imageSrc.
Ciclo de vida
Los estados son pending (pendiente), active (en curso), submitted (resultado enviado), cancelled (cancelada) y expired (caducada). Solo submitted indica que hay un resultado proporcionado por una persona.
Si LCC.assist.request() agota el tiempo de espera, intenta cancelar esa solicitud. Al finalizar normalmente el script, se intenta cancelar las solicitudes pendientes de la instancia actual. Las tareas y los resultados no se conservan tras reiniciar el centro de control; guarda por separado los resultados que necesites después.
Cuando el centro de control recibe el estado de dispositivo detenido, cancela las solicitudes de ayuda lua-script de ese dispositivo que estén en pending / active. Esta cancelación por lotes no afecta a otros dispositivos, otros orígenes ni resultados enviados.
Las capturas subidas automáticamente se eliminan al iniciar el centro de control. Guarda una copia en una ruta de recursos que gestiones si necesitas reutilizarlas a largo plazo; no trates el screenshotPath generado como una referencia permanente.
Las imágenes en línea no se conservan después de enviar el resultado, cancelar o caducar una solicitud.
Lista de API
- Parámetros comunes y objetos devueltos
- Crear una solicitud de asistencia humana
LCC.assist.create() - Esperar el resultado de la asistencia humana
LCC.assist.wait() - Crear y esperar una solicitud
LCC.assist.request() - Solicitar una respuesta de texto
LCC.assist.ask_text() - Solicitar la selección de coordenadas
LCC.assist.pick_point() - Solicitar control remoto manual
LCC.assist.request_control() - Cancelar una solicitud específica
LCC.assist.cancel() - Cancelar las solicitudes del script actual
LCC.assist.cancel_all()