Управление скриптами

Импорт скрипта в консоль

1. Откройте 文件管理 → 脚本目录.
2. Перетащите локальный файл скрипта, папку скрипта или полный плоский каталог скрипта в файловый менеджер.
3. После загрузки скрипт автоматически появится в раскрывающемся списке на главном экране; его можно выбрать и запустить.
4. При большом числе скриптов создавайте папки в 脚本目录 для сортировки.

Что такое плоский скрипт

Консоли удобнее всего управлять «плоскими скриптами» — каталогами, содержащими lua/scripts/main.lua или lua/scripts/main.xxt. Например:

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

После загрузки такого каталога консоль рассматривает всю папку как один запускаемый модуль скрипта: при передаче на устройство структура разворачивается, а входом служит main.lua или main.xxt.

Пакет .xpp также можно управлять как модулем скрипта. Файл формы конфигурации консоли находится в main.json в корне пакета, а не в lua/scripts/.

Зашифрованный пакет .xpa можно открыть двойным щелчком по ассоциации файла или перетащить в 文件管理 → 脚本目录 для установки; после установки в каталоге 脚本目录 появится пакет .xpp.

Запуск и остановка скрипта

1. Выберите скрипт в раскрывающемся списке на главном экране.
2. Выберите целевые устройства в списке устройств.
3. Нажмите «Запустить скрипт» на панели действий: консоль сначала передаст скрипт устройству, затем запустит его.
4. Для остановки нажмите «Остановить скрипт» на той же панели.

Если одновременно выбрана группа с привязанным скриптом, её скрипт имеет приоритет над выбранным на панели действий; подробные правила см. в разделе Группы устройств.

Передача скрипта на устройство и выбор скрипта на устройстве

• Передать скрипт на устройство: пакетно передать выбранный скрипт консоли или «все локальные скрипты», не запуская их сразу.
• Выбрать скрипт на устройстве: только сменить выбранный скрипт на устройстве для последующего ручного запуска.

Добавление формы конфигурации к скрипту

1. В 文件管理 → 脚本目录 щёлкните правой кнопкой плоский каталог скрипта или каталог пакета .xpp.
2. Выберите 编辑脚本 UI 配置.
3. В редакторе интерфейса скрипта измените main.json: для плоского скрипта это lua/scripts/main.json, для .xpp — main.json в корне пакета.
4. Вернитесь на главный экран. Если у скрипта есть форма, рядом с его списком появится кнопка «Конфигурация».

Один и тот же скрипт может использовать параметры main.json по умолчанию или отдельную конфигурацию, сохранённую для группы.

Обновление XXTLanControl.lua

• В 系统配置 → 脚本运行设置 можно задать, следует ли автоматически передавать XXTLanControl.lua перед запуском.
• На той же панели есть функция «Обновить сейчас», заменяющая все имеющиеся в 脚本目录 файлы XXTLanControl.lua версией текущего сервера.