Introducción

XXTLanControl es una plataforma de control central en red local para administrar y controlar dispositivos XXTouch por lotes. Sus componentes principales son:

• Servicio backend: proporciona la API HTTP y se encarga de la comunicación con dispositivos, la gestión de archivos, el almacenamiento de datos y otra lógica principal
• Frontend web: interfaz de administración basada en navegador que incluye lista de dispositivos, gestión de scripts, control remoto, gestión de archivos, KVDB, TableDB, Espacio de trabajo de muestras y otras funciones
• Programa de bandeja (opcional): bandeja del sistema para Windows / macOS que permite iniciar o detener rápidamente el backend y abrir el navegador
• Módulo Lua XXTLanControl.lua: biblioteca de scripts que se ejecuta en el dispositivo y ofrece interfaces para conectarse al control central, enviar registros, usar KVDB y TableDB y operar archivos

Estructura del paquete de distribución

Los nombres de los paquetes de distribución varían según el sistema; normalmente incluyen lo siguiente:

Windows

Ruta / archivo	Descripción
XXTLanControl-tray-windows-amd64.exe	Lanzador de bandeja; al hacer doble clic inicia el backend y permanece en la bandeja.
bin/XXTLanControl-backend-windows-amd64.exe	Servicio backend del control central.
bin/xxtlancontrol-mcpserver.exe	Servicio MCP.
dist/	Raíz de los recursos de ejecución; web/ contiene la consola web y el resto son recursos incluidos en el paquete.
start-backend.cmd	Script de inicio en modo de línea de comandos, útil para investigar problemas.
XXTLanControl.lua	Módulo Lua que utilizan los dispositivos para acceder a las funciones del control central.

macOS

Ruta / archivo	Descripción
XXTLanControl.app	Paquete de la aplicación principal; al hacer doble clic inicia la bandeja y el backend.
XXTLanControl.app/Contents/MacOS/xxtlancontrol-mcpserver	Servicio MCP.
XXTLanControl.app/Contents/Resources/dist/	Raíz de los recursos de ejecución; web/ contiene la consola web y el resto son recursos incluidos en el paquete.
start-backend.command	Script de inicio desde la terminal, útil para investigar problemas.
XXTLanControl.lua	Módulo Lua que utilizan los dispositivos para acceder a las funciones del control central.

Linux

Ruta / archivo	Descripción
XXTLanControl-backend-linux-amd64 / XXTLanControl-backend-linux-arm64	Binarios backend proporcionados según la arquitectura.
xxtlancontrol-mcpserver	Script de inicio de MCP que selecciona automáticamente el binario MCP correspondiente a la arquitectura.
xxtlancontrol-mcpserver-linux-amd64 / xxtlancontrol-mcpserver-linux-arm64	Binarios MCP proporcionados según la arquitectura.
dist/	Raíz de los recursos de ejecución; web/ contiene la consola web y el resto son recursos incluidos en el paquete.
start-backend.sh	Script de inicio en modo de línea de comandos.
XXTLanControl.lua	Módulo Lua que utilizan los dispositivos para acceder a las funciones del control central.

Funciones principales

• Gestión de dispositivos: escanea e importa dispositivos XXTouch de la red local y permite administrarlos por grupos
• Ejecución de scripts: sube scripts al dispositivo y permite iniciarlos, detenerlos o pausarlos en cualquier momento
• Control remoto: muestra la pantalla del dispositivo en tiempo real, admite toques y teclas y permite controlar varios dispositivos a la vez
• Gestión de archivos: administra scripts, recursos, informes y otros archivos del control central, con carga, descarga y edición en línea
• Gestión de datos: incorpora KVDB (colas + diccionarios) y TableDB (tablas estructuradas) para compartir estados entre scripts o almacenar datos de negocio
• Tareas programadas: admite activadores programados, por intervalo, únicos, iniciados por el usuario y de consumo de colas KVDB, además de pasos encadenados y flujos de trabajo visuales
• Espacio de trabajo de muestras: herramientas auxiliares para desarrollar scripts, como selector de color de capturas, recorte de regiones, fuentes de matriz de puntos y captura de elementos de texto
• Operaciones por lotes: autorización, instalación de una nueva versión de XXTouch, cambio de nombres, capturas de pantalla, bloqueo/desbloqueo y otras operaciones por lotes

Requisitos previos

• El dispositivo debe tener XXTouch instalado y acceso remoto habilitado
• El dispositivo y el control central deben estar en la misma red local, y el firewall del control central debe permitir el puerto HTTP (predeterminado 46990)

Primer inicio

• Windows: haz doble clic en XXTLanControl-tray-windows-amd64.exe; normalmente el navegador se abre automáticamente en la consola
• macOS: abre XXTLanControl.app; normalmente el navegador se abre automáticamente en la consola
• Linux: ejecuta start-backend.sh y visita manualmente http://127.0.0.1:46990/

Consulta los capítulos siguientes para obtener más información.