Introduction

XXTLanControl est une plateforme de contrôle centralisé sur réseau local destinée à gérer et contrôler des appareils XXTouch par lots. Elle se compose principalement des éléments suivants :

• Service backend : fournit l'API HTTP et prend en charge la communication avec les appareils, la gestion des fichiers, le stockage des données et les autres fonctions centrales.
• Interface Web : interface de gestion dans le navigateur, avec liste des appareils, gestion des scripts, contrôle à distance, gestion des fichiers, KVDB, TableDB, espace de travail des échantillons et autres fonctions.
• Programme de zone de notification (facultatif) : zone de notification système sous Windows / macOS, pour démarrer ou arrêter rapidement le backend et ouvrir le navigateur.
• Module Lua XXTLanControl.lua : bibliothèque de scripts exécutée sur les appareils, fournissant la connexion au centre de contrôle, la remontée des journaux, KVDB, TableDB, les opérations sur les fichiers et d'autres interfaces.

Structure du paquet de distribution

Le nom du paquet de distribution varie selon le système ; son contenu courant est le suivant :

Windows

Chemin / fichier	Description
XXTLanControl-tray-windows-amd64.exe	Lanceur de zone de notification ; un double-clic démarre le backend et le laisse actif dans la zone de notification.
bin/XXTLanControl-backend-windows-amd64.exe	Service backend du centre de contrôle.
bin/xxtlancontrol-mcpserver.exe	Programme de service MCP.
dist/	Racine des ressources d'exécution ; web/ contient les pages de la console Web et les autres éléments sont les ressources incluses dans le paquet.
start-backend.cmd	Script de démarrage en ligne de commande, pratique pour diagnostiquer les problèmes.
XXTLanControl.lua	Module Lua utilisé par les appareils pour appeler les fonctions du centre de contrôle.

macOS

Chemin / fichier	Description
XXTLanControl.app	Paquet d'application principal ; un double-clic démarre la zone de notification et le backend.
XXTLanControl.app/Contents/MacOS/xxtlancontrol-mcpserver	Programme de service MCP.
XXTLanControl.app/Contents/Resources/dist/	Racine des ressources d'exécution ; web/ contient les pages de la console Web et les autres éléments sont les ressources incluses dans le paquet.
start-backend.command	Script de démarrage dans le terminal, pratique pour diagnostiquer les problèmes.
XXTLanControl.lua	Module Lua utilisé par les appareils pour appeler les fonctions du centre de contrôle.

Linux

Chemin / fichier	Description
XXTLanControl-backend-linux-amd64 / XXTLanControl-backend-linux-arm64	Binaires backend fournis selon l'architecture.
xxtlancontrol-mcpserver	Script de démarrage MCP, qui sélectionne automatiquement le binaire MCP correspondant à l'architecture.
xxtlancontrol-mcpserver-linux-amd64 / xxtlancontrol-mcpserver-linux-arm64	Binaires MCP fournis selon l'architecture.
dist/	Racine des ressources d'exécution ; web/ contient les pages de la console Web et les autres éléments sont les ressources incluses dans le paquet.
start-backend.sh	Script de démarrage en ligne de commande.
XXTLanControl.lua	Module Lua utilisé par les appareils pour appeler les fonctions du centre de contrôle.

Fonctions principales

• Gestion des appareils : scanner et importer les appareils XXTouch du réseau local, avec gestion unifiée par groupe.
• Exécution des scripts : téléverser des scripts vers les appareils, puis les démarrer, arrêter ou mettre en pause à tout moment.
• Contrôle à distance : afficher l'écran de l'appareil en temps réel, envoyer des actions tactiles et des touches, et contrôler plusieurs appareils simultanément.
• Gestion des fichiers : gérer les scripts, ressources, rapports et autres fichiers du centre de contrôle, avec téléversement, téléchargement et édition en ligne.
• Gestion des données : KVDB intégré (file + dictionnaire) et TableDB (table structurée), pour partager l'état entre scripts ou stocker des données métier.
• Tâches planifiées : déclenchement à heure fixe, à intervalle, unique, par l'utilisateur ou par consommation d'une file KVDB, avec orchestration des étapes et flux de travail visuel.
• Espace de travail des échantillons : sélection de couleur sur capture, recadrage de zone, polices matricielles, capture d'éléments textuels et autres outils d'aide au développement de scripts.
• Opérations par lot : autorisation, installation d'une nouvelle version de XXTouch, renommage, capture d'écran, verrouillage/déverrouillage et autres opérations par lot.

Conditions préalables

• XXTouch doit être installé sur l'appareil et 远程访问 doit être activé.
• L'appareil et le centre de contrôle doivent être sur le même réseau local, et le port HTTP du pare-feu du centre de contrôle doit être autorisé (46990 par défaut).

Premier démarrage

• Windows : double-cliquez sur XXTLanControl-tray-windows-amd64.exe; le navigateur ouvre généralement la console automatiquement.
• macOS : ouvrez XXTLanControl.app; le navigateur ouvre généralement la console automatiquement.
• Linux : exécutez start-backend.sh, puis ouvrez manuellement http://127.0.0.1:46990/.

Consultez les chapitres suivants pour plus de détails.