Zum Hauptinhalt springen

XXTLanControl-Modul

XXTLanControl.lua bietet Geräteskripten eine einheitliche Schnittstelle zur Zentrale. Das Modul ist in fünf Hauptbereiche gegliedert:

  • Kernsteuerung: Verbindung initialisieren, Wiederholungsstrategie konfigurieren, UI-Zustand erfassen, Protokollaliase festlegen und Protokolle an die Zentrale senden.
  • Menschliche Unterstützung: Textantworten, Koordinatenauswahl oder Fernsteuerung bei der Zentrale anfordern.
  • Freigegebene Dateien: das „Ressourcenverzeichnis“ im Dateimanager lesen und schreiben.
  • KVDB-Datenoperationen: Queues und Wörterbücher der Zentrale verwalten, einschließlich atomarem Verschieben und Kopieren sowie Hinzufügen, Löschen, Aktualisieren und Abfragen.
  • TableDB-Datenoperationen: strukturierte Tabellen der Zentrale erstellen, abfragen und bearbeiten sowie erweiterte atomare Abrufvorgänge verwenden.

Modul herunterladen​

Klicken Sie hier, um XXTLanControl.lua herunterzuladen

Modul einbinden​

local LCC = require("XXTLanControl")

Vorbereitung​

  • Stellen Sie sicher, dass die XXTouch-Version auf dem Gerät aktuell genug ist.
  • LCC.capture_ui_state() erfordert ui_element 0.6.0 oder höher auf dem Gerät. Wenn das Modul nicht verfügbar oder veraltet ist, aktualisieren Sie XXTouch, bevor Sie capture_ui_state verwenden.
  • Wenn das Skript nicht direkt von der Zentrale gestartet wird, rufen Sie zuerst LCC.set_api_url("http://中控地址:46990") auf.
  • Rufen Sie vor der Verwendung einer Schnittstelle LCC.connect() zur Initialisierung auf.

Wenn die Modulversion auf dem Gerät nicht zur aktuellen Zentrale passt, versucht LCC.connect(), eine neue XXTLanControl.lua von der Zentrale herunterzuladen und anschließend automatisch erneut zu verbinden.

Typische Verwendung​

  • Lesen Sie mit LCC.get_ui_config() die über die Konfigurationsoberfläche eines Flat-Skripts oder XPP-Pakets in main.json übermittelten Parameter.
  • Schreiben Sie mit LCC.log() Protokolle in die Kanäle 1 bis 6 der Zentrale.
  • Erfassen Sie mit LCC.capture_ui_state() Screenshot und Textelementbaum und speichern Sie sie als .xxtuie oder laden Sie sie mit dem Protokoll hoch.
  • Teilen Sie Status oder Geschäftsdaten zwischen Skripten und Oberfläche mit LCC.kvdb und LCC.db.