English · Для авторов расширений

Ваши инструменты в VLTONE

Анализ и нарезка любых аудиоклипов

Свои стили: палитра, карточки, кнопки

Скрипт может быть одной командой, собственным окном или закреплённой панелью. Lua уже встроен в приложение: устанавливать интерпретатор или компилятор не нужно.

Установить и запустить

  1. Откройте Скрипты → Менеджер скриптов → Библиотека → Установить….
  2. Выберите файл .lua, пакет .vltscript или проект Lua .vltcreator. Установка сама не запускает код.
  3. Раскройте расширение слева и выберите его команду. Нажмите Запустить команду.
  4. Если нужен клип или ноты, выделите их перед запуском. При запуске из контекстного меню скрипт получает объект под правой кнопкой, даже если глобальное выделение другое.

Для разового запуска есть Скрипты → Запустить файл…, для поиска установленной команды — Выбрать команду…. В piano roll используйте Alt + правую кнопку или меню действий: обычная правая кнопка служит для удаления нот.

Три раздела менеджера

РазделЧто здесь делать
БиблиотекаУстановка и поиск. Для выбранной команды — горячая клавиша, контекстные меню и запуск. Во вкладке «Расширение» — включение и автозапуск; в «Разрешениях» — доступ к данным.
АктивностьРаботающие и завершённые экземпляры. Выберите запуск, чтобы увидеть журнал. Значки остановки и перехода в Creator доступны по ситуации; текст ошибки находится в журнале.
СправкаЭто руководство, SDK и создание нового инструмента.

Обновление из файла, экспорт, открытие исходников и удаление находятся в верхнем ряду значков библиотеки. Наведите курсор, чтобы увидеть подпись. Обновление сохраняет назначения при неизменных идентификаторах расширения и команды.

Горячая клавиша назначается на вкладке «Команда». Конфликт с другой командой будет показан до сохранения. В списке контекстов можно включить только места, которые поддерживает автор. «Закрепить напрямую» выводит команду отдельным пунктом вместо подменю «Скрипты».

Сделать собственную панель кнопок

  1. Включите Скрипты → Панель скриптов. Изначально она скрыта.
  2. В меню панели откройте настройку. Это отдельное окно: проект остаётся доступным во время настройки.
  3. Нажмите Добавить… и выберите команду. Слева можно изменить порядок стрелками или перетаскиванием и вставить разделители.
  4. На вкладке Вид задайте подпись, выберите «Текст», «Только изображение» или «Изображение и текст». Кнопка предпросмотра сразу показывает результат.
  5. Выберите свою фотографию или значок: PNG, JPEG, WebP, SVG, BMP или ICO. До 8 МиБ и 64 мегапикселей. При сохранении копия изображения остаётся в библиотеке VLTONE.
  6. Нажмите Сохранить. Во вкладке «Аргументы» обычно достаточно оставить {}; специальные значения указывает автор команды.

Панель можно закрепить сверху, снизу, слева или справа, а также вынести в плавающее окно. Меню предоставляет те же действия без перетаскивания. Размещение, видимость и кнопки сохраняются после перезапуска.

Какие данные видит скрипт

Дорожки, клипы, параметры и исходники аудио, на которые ссылается проект, доступны для чтения автоматически, если автор заявил соответствующие права. Для отдельных файлов инструмент открывает стандартное окно выбора. Папку можно выдать в менеджере.

ДоступКак работает
Чтение проекта и его медиаАвтоматически, если не отозвано пользователем. Это не открывает весь диск или соседние файлы.
Изменение проекта и транспортаОтдельное разрешение. Пакет изменений отменяется обычным Undo. В совместном проекте изменение через скрипты заблокировано.
Запись файловОтдельное разрешение и выбранное место назначения. Исходные медиа сохраняются.
Сеть и внешние программыОтдельные разрешения; для программы дополнительно выбирается конкретный исполняемый файл.

Автозапуск выключен при установке. Включайте его отдельно для нужного расширения. После сбоя при автозапуске инструмент приостанавливается до ручного включения. «Остановить все» завершает скрипты и их задания.

Написать скрипт или попросить AI

Откройте Создать в Creator… → Lua-скрипт. Мини-модули остаются отдельным типом проекта. В Creator слева исходники и ресурсы, в центре код и диагностика, справа помощник AI. Ctrl + Space вызывает дополнение, Ctrl + F — поиск.

  1. Опишите помощнику входные данные, результат и интерфейс: например, «Сделай окно с таблицей файлов проекта и кнопкой анализа».
  2. Попросите использовать встроенный SDK, проверить исходники и показать результат в Предпросмотре копии.
  3. Предпросмотр использует копию проекта и тестовые файлы. Доступ к настоящему проекту — отдельная команда Запустить в реальном проекте.
  4. Сохраните проект, установите инструмент и назначьте кнопку или клавишу в менеджере.

Для обмена экспортируйте .vltscript: пакет содержит код и ресурсы. Получателю нужен VLTONE с подходящим SDK. SDK содержит примеры, описание API и инструкции для автора.

Если инструмент не работает

СимптомЧто проверить
Команда не появилась в меню клипаОна включена в менеджере, поддерживает контекст «Клипы» и отмечена в списке контекстных меню.
Слайсер не режет клипЗапустите на аудиоклипе, разрешите изменение проекта, проверьте журнал «Активности». Режим совместной сессии запрещает изменение. Для растянутого, реверсированного или составного клипа алгоритму нужна поддержка соответствующего режима источника.
Файл не доступенОн должен быть исходником проекта, ресурсом пакета или выбранным файлом/выданной папкой. После отзыва прав откройте «Разрешения» и пересмотрите запрос.
«Активируйте проект инструмента»Вернитесь на вкладку проекта, указанного в заголовке окна скрипта. Скрипт сохраняет привязку к исходному проекту.
Ошибки revision или identityПроект изменился либо устройство заменено. Обновите данные инструмента и повторите действие. Автору нужно перечитать снимок перед применением.
Инструмент завис или завершилсяОстановите его в «Активности». Посмотрите ошибку, затем откройте нужную строку в Creator. Длительную обработку автор должен делить на задания и короткие обработчики.