Gerenciamento de scripts

Importar scripts para o controle central

1. Abra 文件管理 → 脚本目录.
2. Arraste arquivos de script locais, pastas de scripts ou um diretório de script plano completo para o gerenciador de arquivos.
3. Depois do upload, o script aparecerá automaticamente na lista suspensa de scripts da interface principal e poderá ser selecionado e executado.
4. Se houver muitos scripts, crie pastas em 脚本目录 para organizá-los por categoria.

O que são scripts planos

O controle central gerencia melhor os "scripts planos", isto é, diretórios que contêm lua/scripts/main.lua ou lua/scripts/main.xxt. Por exemplo:

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

Depois que um diretório desse tipo é enviado, o controle central trata a pasta inteira como uma unidade de script executável; ao transferi-la para um dispositivo, expande sua estrutura e usa main.lua ou main.xxt como ponto de entrada.

Pacotes de scripts .xpp também podem ser gerenciados como unidades de script. O arquivo da interface de configuração do controle central fica no main.json da raiz do pacote, e não em lua/scripts/.

Pacotes criptografados .xpa podem ser abertos com um clique duplo por meio da associação de arquivos ou instalados ao serem arrastados para 文件管理 → 脚本目录; depois da instalação, tornam-se um pacote de scripts .xpp em 脚本目录.

Iniciar e parar scripts

1. Selecione um script na lista suspensa de scripts da interface principal.
2. Marque os dispositivos de destino na lista de dispositivos.
3. Clique em "Iniciar script" na barra de ações; o controle central enviará primeiro o script ao dispositivo e depois o iniciará.
4. Para parar, clique em "Parar script" na mesma barra de ações.

Se grupos também estiverem marcados e tiverem scripts associados, os scripts dos grupos terão prioridade sobre o script selecionado na barra de ações. Consulte as regras detalhadas em grupos de dispositivos.

Enviar scripts para o dispositivo / selecionar um script no dispositivo

• Enviar scripts para o dispositivo: transfere em lote um script do controle central ou "todos os scripts locais" para os dispositivos, sem iniciá-lo imediatamente.
• Selecionar um script específico no dispositivo: apenas troca o script atualmente selecionado no dispositivo, o que é útil para executá-lo manualmente depois no próprio dispositivo.

Adicionar uma interface de configuração ao script

1. Em 文件管理 → 脚本目录, clique com o botão direito em um diretório de script plano ou em um diretório de pacote de scripts .xpp.
2. Escolha 编辑脚本 UI 配置.
3. Mantenha main.json no editor de interface de scripts: para scripts planos, é lua/scripts/main.json; para .xpp, é o main.json na raiz do pacote.
4. Ao voltar à interface principal, um botão "Configurar" aparecerá à direita da lista suspensa se o script atual tiver uma interface de configuração.

O mesmo script pode usar os parâmetros padrão de main.json e também ter uma configuração exclusiva salva em um grupo.

Atualizar XXTLanControl.lua

• Em 系统配置 → 脚本运行设置, defina se XXTLanControl.lua deve ser transferido automaticamente antes da execução de scripts.
• O mesmo painel oferece a função "Atualizar agora", que substitui em lote os arquivos XXTLanControl.lua existentes em 脚本目录 pela versão atual do servidor.