Saltar al contenido principal

Administración de scripts

Importar scripts al control central​

  1. Abre Gestor de archivos → Directorio de scripts.
  2. Arrastra al Gestor de archivos un archivo de script local, una carpeta de scripts o un directorio de scripts plano completo.
  3. Cuando termine la carga, el script aparecerá automáticamente en la lista desplegable de scripts de la interfaz principal y podrás seleccionarlo y ejecutarlo.
  4. Si tienes muchos scripts, crea carpetas en Directorio de scripts para clasificarlos y organizarlos.

Qué es un script plano​

Lo que mejor administra el control central son los "scripts planos": directorios que contienen lua/scripts/main.lua o lua/scripts/main.xxt. Por ejemplo:

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

Después de subir un directorio de este tipo, el control central tratará toda la carpeta como una unidad de script ejecutable; al transferirla al dispositivo, la desplegará según su estructura y usará main.lua o main.xxt como entrada.

Los paquetes de scripts .xpp también se pueden administrar como unidades de script. El archivo de configuración de la interfaz del control central se encuentra en el main.json de la raíz del paquete, no en lua/scripts/.

Los paquetes cifrados .xpa se pueden abrir con un doble clic mediante la asociación de archivos o instalarse al arrastrarlos a Gestor de archivos → Directorio de scripts; después de instalarlos, se convierten en paquetes .xpp dentro de Directorio de scripts.

Iniciar y detener scripts​

  1. Selecciona el script en la lista desplegable de scripts de la interfaz principal.
  2. Marca los dispositivos de destino en Lista de dispositivos.
  3. Haz clic en Iniciar script en la barra de acciones; el control central transferirá primero el script al dispositivo y después lo iniciará.
  4. Para detenerlo, haz clic en Detener script en la misma barra de acciones.

Si también marcas grupos y estos tienen scripts asociados, los scripts de grupo tendrán prioridad sobre el script seleccionado actualmente en la barra de acciones. Consulta las reglas detalladas en Grupos de dispositivos.

Subir scripts al dispositivo o seleccionar un script en él​

  • Subir scripts al dispositivo: transfiere por lotes un script del control central o "todos los scripts locales" al dispositivo, pero no lo inicia de inmediato.
  • Seleccionar un script específico en el dispositivo: solo cambia el script seleccionado actualmente en el dispositivo y resulta útil para ejecutarlo manualmente allí más adelante.

Añadir una interfaz de configuración a un script​

  1. En Gestor de archivos → Directorio de scripts, abre el menú contextual de un directorio de scripts plano o de un directorio de paquete .xpp.
  2. Selecciona Editar configuración de UI del script.
  3. Mantén main.json en el editor de interfaz del script: para scripts planos es lua/scripts/main.json, y para .xpp es el main.json de la raíz del paquete.
  4. Al volver a la interfaz principal, si el script actual tiene una interfaz de configuración, aparecerá el botón Configuración a la derecha de su lista desplegable.

Un mismo script puede usar los parámetros predeterminados de main.json y también guardar una configuración exclusiva para un grupo.

Actualizar XXTLanControl.lua​

  • En Configuración del sistema → Configuración de ejecución de scripts, puedes definir si XXTLanControl.lua se transfiere automáticamente antes de ejecutar un script.
  • El mismo panel ofrece Actualizar ahora, que sustituye por lotes los XXTLanControl.lua existentes en Directorio de scripts por la versión actual del servidor.