OSC: управление извне
Протокол, на котором говорят все приложения для X32. Как устроены адреса, как подписаться на изменения и что можно автоматизировать.
Как объяснил бы коллега за пультом: коротко и по делу.
OSC — протокол, по которому с пультом разговаривают X32-Edit, планшетные приложения, Companion и любые ваши скрипты. Каждый параметр пульта имеет адрес.
Обмен идёт по UDP, порт 10023. Полный перечень адресов — в справочнике OSC и MIDI, разбор чужого адреса — в калькуляторах.
/ch/01/mix/fader уровень канала 1 значение 0.0 … 1.0
/ch/01/mix/on мьют канала 1 0 — заглушен, 1 — открыт
/ch/01/config/name имя канала строка
/bus/03/mix/fader уровень шины 3
/dca/2/on мьют DCA 2
/-action/goscene перейти к сцене номер
Структура читается слева направо: объект, номер, раздел, параметр.
/ch/01/mix/on 0 означает «канал выключен», а 1 — «канал звучит». Логика
обратна названию кнопки Mute на пульте. Скрипты, написанные наоборот, глушат
всё ровно тогда, когда должны включать.
Три способа общения
Отправляете адрес без значения — пульт отвечает текущим. Отправляете со значением — параметр меняется.
Служебная команда подписки заставляет пульт присылать изменения самому. Подписку нужно периодически продлевать, она живёт несколько секунд. Так работают приложения: иначе фейдеры на планшете не двигались бы вслед за пультом. Несколько клиентов сразу.
Что автоматизируют
Кнопки на стрим-деке: смена сцены, мьют группы микрофонов, talkback, запуск записи. Companion общается с X32 по OSC из коробки.
Синхронизацию со светом и видео: свет по таймкоду переключает сцену, звук меняет режим по той же метке.
Свои пульты управления: планшет с четырьмя большими кнопками для ведущего или техника, который не должен видеть остальной микс.
Логику, которой нет в пульте, вроде «если посыл в монитор поднялся выше порога, приглушить соседний канал».
С чего начать
- Настроить сеть и убедиться, что пульт пингуется.
- Взять любой OSC-клиент и отправить
/info— пульт ответит именем и версией. - Попробовать
/ch/01/mix/faderс разными значениями. - Дальше — справочник адресов.
Отлаживайте на пульте, который не стоит на мероприятии. OSC меняет параметры мгновенно и без подтверждений, и ошибка в скрипте выражается в тишине или в мастере на максимуме.
OSC — протокол, по которому с пультом разговаривают X32-Edit, планшетные приложения, Companion и любые ваши скрипты. Каждый параметр пульта имеет адрес.
Обмен идёт по UDP, порт 10023. Полный перечень адресов — в справочнике OSC и MIDI.
Как выглядит адрес
/ch/01/mix/fader уровень канала 1 значение 0.0 … 1.0
/ch/01/mix/on мьют канала 1 0 — заглушен, 1 — открыт
/ch/01/config/name имя канала строка
/bus/03/mix/fader уровень шины 3
/dca/2/on мьют DCA 2
/-action/goscene перейти к сцене номер
Структура читается слева направо: объект, номер, раздел, параметр.
/ch/01/mix/on 0 означает «канал выключен», а 1 — «канал звучит». Логика
обратна названию кнопки Mute на пульте. Скрипты, написанные наоборот, глушат
всё ровно тогда, когда должны включать.
Три способа общения
Запрос. Отправляете адрес без значения — пульт отвечает текущим.
Установка. Отправляете адрес со значением — параметр меняется.
Подписка. Отправляете служебную команду подписки, и пульт сам присылает изменения. Подписку нужно периодически продлевать — она живёт несколько секунд. Именно так работают приложения: иначе фейдеры на планшете не двигались бы вслед за пультом.
Что автоматизируют на практике
Кнопки на стрим-деке. Смена сцены, мьют группы микрофонов, talkback, запуск записи. Companion общается с X32 по OSC из коробки.
Синхронизация со светом и видео. Свет по таймкоду переключает сцену, звук меняет режим по той же метке.
Свои пульты управления. Планшет с четырьмя большими кнопками для ведущего или техника, который не должен видеть остальной микс.
Логика, которой нет в пульте. Например, «если поднялся посыл в монитор выше порога — приглушить соседний канал». Скрипт на компьютере делает то, чего пульт сам не умеет.
С чего начать
- Настроить сеть и убедиться, что пульт пингуется.
- Взять любой OSC-клиент и отправить
/info— пульт ответит именем и версией. - Попробовать
/ch/01/mix/faderс разными значениями. - Дальше — справочник адресов.
Отлаживайте на пульте, который не стоит на мероприятии. OSC меняет параметры мгновенно и без подтверждений — ошибка в скрипте выражается в тишине или в мастере на максимуме.
На других пультах
весь переводчик →- Allen & Heath dLiveMIDI / TCP control
- DiGiCo SD / QuantumOSC
- Yamaha CL / QLRemote Control Protocol