Einführung

XXTLanControl ist eine Zentralenplattform im lokalen Netzwerk zur stapelweisen Verwaltung und Steuerung von XXTouch-Geräten. Sie umfasst hauptsächlich folgende Bereiche:

• Backend-Dienst: stellt die HTTP-API bereit und übernimmt Gerätekommunikation, Dateiverwaltung und Datenspeicherung.
• Web-Frontend: browserbasierte Verwaltungsoberfläche für Geräteliste, Skriptverwaltung, Fernsteuerung, Dateiverwaltung, KVDB, TableDB und Sample Workbench.
• Tray-Programm (optional): System-Tray für Windows/macOS zum schnellen Starten und Stoppen des Backends sowie zum Öffnen des Browsers.
• Lua-Modul XXTLanControl.lua: auf dem Gerät ausgeführte Skriptbibliothek mit APIs für die Verbindung zur Zentrale, Protokollübertragung, KVDB, TableDB und Dateioperationen.

Struktur des Release-Pakets

Die Namen der Distributionspakete unterscheiden sich je nach System; typische Inhalte sind:

Windows

Pfad / Datei	Beschreibung
XXTLanControl-tray-windows-amd64.exe	Tray-Starter: startet das Backend per Doppelklick und bleibt im Tray aktiv.
bin/XXTLanControl-backend-windows-amd64.exe	Backend-Dienst der Zentrale.
bin/xxtlancontrol-mcpserver.exe	MCP-Dienstprogramm.
dist/	Stammverzeichnis der Laufzeitressourcen: web/ enthält die Webkonsole, der Rest sind Paketressourcen.
start-backend.cmd	Startskript für den Kommandozeilenmodus zur Fehlersuche.
XXTLanControl.lua	Lua-Modul für den Zugriff der Geräte-Skripte auf die Zentrale.

macOS

Pfad / Datei	Beschreibung
XXTLanControl.app	Haupt-App-Paket; per Doppelklick werden Tray und Backend gestartet.
XXTLanControl.app/Contents/MacOS/xxtlancontrol-mcpserver	MCP-Dienstprogramm.
XXTLanControl.app/Contents/Resources/dist/	Stammverzeichnis der Laufzeitressourcen: web/ enthält die Webkonsole, der Rest sind Paketressourcen.
start-backend.command	Startskript für den Terminalmodus zur Fehlersuche.
XXTLanControl.lua	Lua-Modul für den Zugriff der Geräte-Skripte auf die Zentrale.

Linux

Pfad / Datei	Beschreibung
XXTLanControl-backend-linux-amd64 / XXTLanControl-backend-linux-arm64	Architekturabhängige Backend-Binärdateien.
xxtlancontrol-mcpserver	MCP-Startskript, das automatisch die passende Architektur auswählt.
xxtlancontrol-mcpserver-linux-amd64 / xxtlancontrol-mcpserver-linux-arm64	Architekturabhängige MCP-Binärdateien.
dist/	Stammverzeichnis der Laufzeitressourcen: web/ enthält die Webkonsole, der Rest sind Paketressourcen.
start-backend.sh	Startskript für den Kommandozeilenmodus.
XXTLanControl.lua	Lua-Modul für den Zugriff der Geräte-Skripte auf die Zentrale.

Hauptfunktionen

• Geräteverwaltung: XXTouch-Geräte im LAN scannen und importieren; gemeinsame Verwaltung nach Gruppen.
• Skriptausführung: Skripte auf Geräte hochladen und jederzeit starten, stoppen oder pausieren.
• Fernsteuerung: Gerätebildschirme in Echtzeit anzeigen, Touch- und Tastatureingaben senden und mehrere Geräte gleichzeitig steuern.
• Dateiverwaltung: Skripte, Ressourcen und Berichte auf der Zentrale verwalten, einschließlich Hochladen, Herunterladen und Online-Bearbeitung.
• Datenverwaltung: integriertes KVDB (Queue + Wörterbuch) und TableDB (strukturierte Tabellen) zum Teilen von Status und Speichern von Geschäftsdaten zwischen Skripten.
• Geplante Aufgaben: zeitgesteuerte, Intervall-, einmalige, benutzergetriggerte sowie durch KVDB-Queue-Verbrauch ausgelöste Ausführungen sowie schrittbasierte und visuelle Workflows.
• Sample Workbench: Entwicklungswerkzeuge wie Screenshot-Farbpipette, Auswahlzuschnitt, Bitmap-Wörterbücher und Textelement-Erfassung.
• Stapelaktionen: Stapelautorisierung, Installation neuer XXTouch-Versionen, Umbenennen, Screenshots sowie Sperren/Entsperren.

Voraussetzungen

• Auf dem Gerät muss XXTouch installiert und 远程访问 aktiviert sein.
• Gerät und Zentrale müssen sich im selben LAN befinden; die Firewall der Zentrale muss den HTTP-Port (Standard 46990) freigeben.

Erster Start

• Windows: Doppelklicken Sie auf XXTLanControl-tray-windows-amd64.exe; der Browser öffnet normalerweise automatisch die Konsole.
• macOS: Öffnen Sie XXTLanControl.app; der Browser öffnet normalerweise automatisch die Konsole.
• Linux: Führen Sie start-backend.sh aus und öffnen Sie anschließend manuell http://127.0.0.1:46990/.

Weitere Verwendungsmöglichkeiten finden Sie in den folgenden Abschnitten.