Passer au contenu principal

Module XXTLanControl

XXTLanControl.lua fournit aux scripts exécutés sur l'appareil une interface unifiée pour interagir avec le serveur du centre de contrôle. Le module est actuellement organisé autour de cinq domaines :

  • Contrôle principal : initialiser la connexion, configurer la stratégie de nouvelle tentative, capturer l'état de l'interface, définir les alias des journaux et envoyer les journaux au centre de contrôle.
  • Assistance humaine : envoyer au centre de contrôle des demandes de réponse textuelle, de sélection de coordonnées ou de contrôle à distance.
  • Fichiers partagés : lire et écrire dans le « répertoire de ressources » du gestionnaire de fichiers.
  • Opérations de données KVDB : manipuler les files et les dictionnaires côté centre de contrôle, avec déplacement atomique, copie et opérations CRUD.
  • Opérations sur les tables de données : utiliser les tables de données structurées du centre de contrôle, avec création, interrogation, modification et opérations avancées telles que la récupération atomique.

Télécharger le module​

Cliquer ici pour télécharger XXTLanControl.lua

Importer le module​

local LCC = require("XXTLanControl")

Avant de commencer​

  • Vérifiez d'abord que la version de XXTouch installée sur l'appareil est suffisamment récente.
  • LCC.capture_ui_state() nécessite ui_element 0.6.0 ou une version ultérieure sur l'appareil ; si le module est indisponible ou la version trop ancienne, mettez XXTouch à jour avant d'utiliser capture_ui_state.
  • Si le script n'est pas lancé directement par le centre de contrôle, appelez d'abord LCC.set_api_url("http://中控地址:46990").
  • Avant d'utiliser une interface, exécutez LCC.connect() pour terminer l'initialisation.

Lorsque la version du module sur l'appareil ne correspond pas à celle du centre de contrôle, LCC.connect() tente de télécharger la nouvelle version de XXTLanControl.lua depuis le centre de contrôle, puis se reconnecte automatiquement.

Modes d'utilisation courants​

  • Utilisez LCC.get_ui_config() pour lire les paramètres envoyés par l'interface de configuration de main.json d'un script aplati ou d'un paquet de script XPP.
  • Utilisez LCC.log() pour renvoyer les journaux vers les colonnes de journal numérotées de 1 à 6 du centre de contrôle.
  • Utilisez LCC.capture_ui_state() pour capturer la capture d'écran et l'arbre des éléments textuels, puis les enregistrer au format .xxtuie ou les téléverser avec le journal.
  • Utilisez LCC.kvdb, LCC.db et les fonctions d'interface pour partager l'état ou les données métier avec l'écran de données.