Saltar al contenido principal

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​

TipoAPIEscenario adecuadoTratamiento habitual del script
Respuesta de textoLCC.assist.ask_text()Códigos de verificación, códigos SMS, contraseñas y tokens de un solo usoIntroduce result.text en el campo de entrada actual
Selección de coordenadasLCC.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 inesperadoLlama directamente a touch.tap(result.x, result.y)
Control remoto manualLCC.assist.request_control()Controles deslizantes, verificación CAPTCHA, inicio de sesión, comprobaciones de seguridad y diálogos de permisos, entre otros flujos inestablesEspera 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íz files del control central, pasa directamente la ruta relativa.
  • screenshotImage: objeto ImageObject de 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 imagen data:image/..., http(s)://... o /api/..., puede pasarla en input para 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​