Saltar al contenido principal

Módulo XXTLanControl

XXTLanControl.lua proporciona a los scripts del dispositivo una interfaz unificada para interactuar con el servidor de control central. Actualmente, el módulo se divide en cinco áreas:

  • Control principal: inicializa la conexión, configura la estrategia de reintentos, captura el estado de la interfaz, establece alias de registros y envía registros al control central.
  • Asistencia humana: inicia solicitudes de respuesta de texto, selección de coordenadas o control remoto en el control central.
  • Archivos compartidos: lee y escribe en el «directorio de recursos» del Gestor de archivos.
  • Operaciones de datos KVDB: operaciones de colas y diccionarios en el control central, con movimiento atómico, copia y operaciones CRUD.
  • Operaciones de tablas de datos: tablas estructuradas en el control central, con creación, consulta y edición de datos estructurados, además de operaciones avanzadas como obtener filas de forma atómica.

Descargar el módulo​

Haz clic aquí para descargar XXTLanControl.lua

Importar el módulo​

local LCC = require("XXTLanControl")

Antes de empezar​

  • Confirma primero que el dispositivo tenga una versión suficientemente reciente de XXTouch.
  • LCC.capture_ui_state() requiere que el dispositivo tenga ui_element 0.6.0 o posterior; si el módulo no está disponible o la versión es demasiado antigua, actualiza XXTouch antes de usar capture_ui_state.
  • Si el script no se inicia directamente desde el control central, llama primero a LCC.set_api_url("http://direccion-control:46990").
  • Antes de usar cualquier interfaz, ejecuta LCC.connect() para completar la inicialización.

Cuando la versión del módulo del dispositivo no coincide con la del control central actual, LCC.connect() intentará descargar de nuevo la versión más reciente de XXTLanControl.lua desde el control central y volverá a conectarse automáticamente.

Formas habituales de uso​

  • Usa LCC.get_ui_config() para leer los parámetros enviados por la interfaz de configuración de un script independiente o del paquete de script XPP main.json.
  • Usa LCC.log() para escribir los registros en las columnas 1-6 del control central.
  • Usa LCC.capture_ui_state() para capturar la pantalla y el árbol de elementos de texto, y guardarlos como .xxtuie o subirlos con el registro.
  • Usa LCC.kvdb y LCC.db para compartir estados o datos de negocio con las funciones de datos de la interfaz.