Passer au contenu principal

Gestion des scripts

Importer des scripts dans le centre de contrôle​

  1. Ouvrez 文件管理 → 脚本目录.
  2. Faites glisser dans le gestionnaire de fichiers le fichier de script local, le dossier de scripts ou le répertoire complet d'un script aplati.
  3. Après le téléversement, le script apparaît automatiquement dans la liste déroulante des scripts de l'interface principale et peut être sélectionné et exécuté directement.
  4. Lorsque les scripts sont nombreux, créez des dossiers dans 脚本目录 pour les classer.

Qu'est-ce qu'un script aplati ?​

Le centre de contrôle gère principalement les « scripts aplatis », c'est-à-dire des répertoires contenant lua/scripts/main.lua ou lua/scripts/main.xxt. Exemple :

我的脚本/
├── res/
│   ├── icon.png
│   └── sample.png
└── lua/
    ├── helper.lua
    └── scripts/
        ├── main.lua
        └── main.json

Après le téléversement d'un tel répertoire, le centre de contrôle traite le dossier entier comme une unité de script exécutable : lors de la transmission à l'appareil, il est déployé selon sa structure et main.lua ou main.xxt sert de point d'entrée.

Un paquet de scripts .xpp peut également être géré comme une unité. Son fichier de configuration d'interface est placé dans le main.json à la racine du paquet, et non dans lua/scripts/.

Un paquet chiffré .xpa peut être ouvert par double-clic via l'association de fichiers ou installé après avoir été déposé dans 文件管理 → 脚本目录 ; après l'installation, il devient sous 脚本目录 un paquet .xpp.

Démarrer et arrêter un script​

  1. Sélectionnez le script dans la liste déroulante de l'interface principale.
  2. Cochez les appareils cibles dans la liste des appareils.
  3. Cliquez sur « Démarrer le script » dans la barre d'actions ; le centre de contrôle transfère d'abord le script à l'appareil, puis le démarre.
  4. Pour l'arrêter, cliquez sur « Arrêter le script » dans la même barre d'actions.

Si un groupe est également coché et qu'un script lui est associé, le script du groupe est prioritaire sur celui sélectionné dans la barre d'actions. Consultez les groupes d'appareils pour le détail des règles.

Téléverser un script vers l'appareil / sélectionner un script sur l'appareil​

  • Téléverser un script vers l'appareil : transmet un script du centre de contrôle ou « tous les scripts locaux » à l'appareil par lot, sans le démarrer immédiatement.
  • Sélectionner un script précis sur l'appareil : change uniquement le script actuellement sélectionné sur l'appareil, pour permettre ensuite une exécution manuelle sur celui-ci.

Ajouter une interface de configuration à un script​

  1. Dans 文件管理 → 脚本目录, cliquez avec le bouton droit sur un répertoire de script aplati ou un répertoire de paquet .xpp.
  2. Choisissez 编辑脚本 UI 配置.
  3. Dans l'éditeur d'interface, maintenez main.json : un script aplati utilise lua/scripts/main.json, tandis qu'un paquet .xpp utilise le main.json à la racine du paquet.
  4. De retour à l'interface principale, un bouton « Configuration » apparaît à droite de la liste déroulante si le script possède une interface de configuration.

Un même script peut utiliser les paramètres par défaut de main.json et une configuration dédiée enregistrée sur un groupe.

Mettre à jour XXTLanControl.lua​

  • Dans 系统配置 → 脚本运行设置, choisissez si XXTLanControl.lua doit être automatiquement transmis avant l'exécution d'un script.
  • Le même panneau propose une fonction « Mettre à jour maintenant » qui remplace par lot, dans 脚本目录, les fichiers XXTLanControl.lua existants par la version du serveur courant.