REST-API, веб-сервер и MCP
Композиция как веб-сервер: панель на планшете без единой установки. И MCP, которым её собирает ИИ-приложение.
Управление по HTTP из браузера, планшета или скрипта. Плюс локальные MCP-серверы, которыми композицию собирает ИИ-приложение.
Как объяснил бы коллега за пультом: коротко и по делу.
Программа умеет работать веб-сервером: композицией управляют обычными HTTP-запросами, состояние читают тем же способом.
Появились REST-API и встроенный веб-сервер. В комплекте идут примеры: страница запуска клипов для планшета и почти полная копия интерфейса в браузере, обе с открытым исходным кодом.
Через него добавляют, удаляют и чистят колонки, слои и группы, управляют эффектами на всех уровнях, забирают миниатюры клипов, перечисляют доступные эффекты и источники и подписываются на изменения композиции через WebSocket.
API дотянулся до групп, колонок и перемещения эффектов.
Включается в Preferences → Webserver, там же виден адрес машины. Порт
по умолчанию 8080 у Arena и Avenue и 8081 у Wire; адрес прослушивания
0.0.0.0 означает все активные адреса, а 127.0.0.1 запрёт сервер
на локальной машине.
Своя панель без TouchOSC
В настройках задаётся корневая папка сервера. Всё, что в ней лежит,
доступно любому устройству с доступом к серверу, а index.html оттуда
становится стартовой страницей. Так собирают панель под конкретное шоу:
несколько крупных кнопок, работающих с планшета, без установки чего-либо
на сам планшет.
Папку с именем API в корневой директории создавать нельзя: это имя
занято самим сервером.
| REST-API | OSC | |
|---|---|---|
| Транспорт | HTTP, доставка гарантирована | UDP, сообщения теряются |
| Чтение состояния | Штатно, включая миниатюры | Через пресеты отдачи |
| Подписка на изменения | WebSocket | Поток сообщений |
| Задержка | Выше | Ниже |
| Что делать во время шоу | Панели, автоматизация | Живое управление руками |
На практике OSC берут для того, что крутится под пальцами прямо сейчас, а REST — для панелей, интеграций и всего, где важна доставка.
MCP
Появились локальные MCP-серверы для Arena, Avenue и Wire. ИИ-приложение с поддержкой MCP собирает композицию по описанию: слои, колонки, клипы, эффекты, загрузка файлов. В Wire оно строит патч — расставляет ноды, соединяет их, задаёт значения, переименовывает и раскрашивает.
Работает это поверх того же REST-API, отсюда и границы. Сервер Arena не умеет трогать слайсы и экраны в Advanced Output, назначения на клавиши, MIDI, DMX и OSC, точки входа клипов, пресеты любого рода, огибающие параметров и ручки Dashboard; записывать композицию и рендерить клипы он тоже не умеет. И видит только текущую деку, хотя переключить её может.
Сборка и правка композиции дома: сделать сорок клипов с именами по списку, повесить один эффект на все слои, найти в композиции файлы не в DXV. Во время живого показа этим не пользуются.
Веб-сервер при этом доступен всем, кто видит машину по сети. На площадке с открытым Wi-Fi это стоит помнить: либо ограничить адрес прослушивания, либо работать в отдельной сети.
Программа умеет работать веб-сервером: композицией управляют обычными HTTP-запросами, а состояние читают тем же способом.
Появились REST-API и встроенный веб-сервер. В комплекте идут примеры: страница запуска клипов для планшета и почти полная копия интерфейса в браузере, обе с открытым исходным кодом.
Что умеет
- добавлять, удалять и чистить колонки, слои и группы;
- управлять эффектами композиции, групп, слоёв и клипов;
- отдавать миниатюры клипов;
- перечислять доступные эффекты и источники;
- подписываться на изменения композиции и параметров через WebSocket.
API дотянулся до групп, колонок и перемещения эффектов.
Как включить
Preferences → Webserver: там же виден адрес машины и кнопка включения. После включения по адресу открывается стартовая страница.
Порт по умолчанию — 8080 у Arena и Avenue, 8081 у Wire. Адрес
прослушивания по умолчанию 0.0.0.0, то есть все активные адреса машины;
127.0.0.1 ограничит доступ локальной машиной.
Своя панель
В настройках задаётся корневая папка веб-сервера. Всё, что в ней лежит,
доступно любому устройству с доступом к серверу, а положенный туда
index.html становится стартовой страницей.
Так собирают панель под конкретное шоу: несколько крупных кнопок, работающих с планшета, без TouchOSC и без установки чего-либо на планшет.
Папку с именем API в корневой директории создавать нельзя: это имя
занято самим сервером.
Чем это лучше и хуже OSC
| REST-API | OSC | |
|---|---|---|
| Транспорт | HTTP, доставка гарантирована | UDP, сообщения теряются |
| Чтение состояния | Штатно, включая миниатюры | Через пресеты отдачи |
| Подписка на изменения | WebSocket | Поток сообщений |
| Задержка | Выше | Ниже |
| Что делать во время шоу | Панели, автоматизация | Живое управление руками |
Практика такая: OSC для того, что крутится под пальцами прямо сейчас, REST для панелей, интеграций и всего, где важна доставка.
MCP-серверы
Появились локальные MCP-серверы для Arena, Avenue и Wire. ИИ-приложение с поддержкой MCP собирает композицию по описанию: слои, колонки, клипы, эффекты, загрузка файлов. В Wire оно строит патч — расставляет ноды, соединяет их, задаёт значения, переименовывает и раскрашивает.
Работает это поверх того же REST-API, отсюда и границы возможностей. Сервер Arena не умеет:
- создавать и править слайсы и экраны в Advanced Output;
- трогать назначения на клавиши, MIDI, DMX и OSC;
- работать с точками входа клипов;
- применять и создавать пресеты — эффектов, источников, анимаций, вывода, раскладки;
- править огибающие параметров;
- читать и менять ручки Dashboard;
- записывать композицию и рендерить клипы.
Ещё одно ограничение: доступны только клипы и файлы текущей деки, хотя деку он может переключить и работать дальше.
Сборка и правка композиции дома: сделать сорок клипов с именами по списку, повесить один эффект на все слои, найти в композиции файлы не в DXV. Во время живого показа этим не пользуются.
Сеть
Веб-сервер доступен всем, кто видит машину по сети. На площадке с открытым Wi-Fi это стоит держать в голове: ограничьте адрес прослушивания или работайте в отдельной сети.