К содержанию
fohbookбета/ Resolume

REST-API, веб-сервер и MCP

Композиция как веб-сервер: панель на планшете без единой установки. И MCP, которым её собирает ИИ-приложение.

Версия вашего пульта:3 фрагмента статьи для версий новее вашей3 фрагмента статьи для версий новее вашей3 фрагмента статьи для версий новее вашей3 фрагмента статьи для версий новее вашей3 фрагмента статьи для версий новее вашей3 фрагмента статьи для версий новее вашей3 фрагмента статьи для версий новее вашей3 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей2 фрагмента статьи для версий новее вашей1 фрагмент статьи для версий новее вашей1 фрагмент статьи для версий новее вашей1 фрагмент статьи для версий новее вашей1 фрагмент статьи для версий новее вашей1 фрагмент статьи для версий новее вашей1 фрагмент статьи для версий новее вашей1 фрагмент статьи для версий новее вашей1 фрагмент статьи для версий новее вашей
Быстрый выбор:

Программа умеет работать веб-сервером: композицией управляют обычными HTTP-запросами, состояние читают тем же способом.

Появилось в 7.8 · в вашей версии этого нет

Появились REST-API и встроенный веб-сервер. В комплекте идут примеры: страница запуска клипов для планшета и почти полная копия интерфейса в браузере, обе с открытым исходным кодом.

Через него добавляют, удаляют и чистят колонки, слои и группы, управляют эффектами на всех уровнях, забирают миниатюры клипов, перечисляют доступные эффекты и источники и подписываются на изменения композиции через WebSocket.

Появилось в 7.18 · в вашей версии этого нет

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

Появилось в 7.26 · в вашей версии этого нет

Появились локальные MCP-серверы для Arena, Avenue и Wire. ИИ-приложение с поддержкой MCP собирает композицию по описанию: слои, колонки, клипы, эффекты, загрузка файлов. В Wire оно строит патч — расставляет ноды, соединяет их, задаёт значения, переименовывает и раскрашивает.

Работает это поверх того же REST-API, отсюда и границы. Сервер Arena не умеет трогать слайсы и экраны в Advanced Output, назначения на клавиши, MIDI, DMX и OSC, точки входа клипов, пресеты любого рода, огибающие параметров и ручки Dashboard; записывать композицию и рендерить клипы он тоже не умеет. И видит только текущую деку, хотя переключить её может.

Где это уместно

Сборка и правка композиции дома: сделать сорок клипов с именами по списку, повесить один эффект на все слои, найти в композиции файлы не в DXV. Во время живого показа этим не пользуются.

Веб-сервер при этом доступен всем, кто видит машину по сети. На площадке с открытым Wi-Fi это стоит помнить: либо ограничить адрес прослушивания, либо работать в отдельной сети.

Нашли в статье ошибку, устаревшее или непонятное место?

рядом по смыслу