К содержанию
fohbook/ TouchDesigner
уверенный

OSC

Управление по сети: адреса, порты, обмен с пультами, планшетом и другими машинами.

OSC — сообщения по сети: адрес вида /scene/next и значения. Основной способ связать TouchDesigner с планшетом, звуковым пультом, световой консолью, Companion и другими машинами.

Операторы

Оператор Для чего
OSC In CHOP Числа: сообщения становятся каналами
OSC In DAT Сообщения как таблица: адрес, значения — для строк и разбора
OSC Out CHOP Отправка каналов
OSC Out DAT Отправка произвольных сообщений

Настройка

  • Порт — на приём. Договорённость важнее «правильного» номера: запишите порты в документацию проекта.
  • Адрес и порт получателя — для отправки.
  • Local Address — если в машине несколько сетевых карт, укажите, с какой слушать и слать. Без этого пакеты уйдут не в тот интерфейс — Сеть.

Адреса

Держите схему адресов осмысленной и плоской:

/scene/goto      i    номер сцены
/scene/next      -    импульс
/master/level    f    0..1
/layer/1/opacity f    0..1
/text/line       s    строка

OSC In CHOP превращает адрес в имя канала автоматически (слэши в подчёркивания). Для строк и сложных сообщений нужен OSC In DAT с колбэком — Скрипты.

С кем говорят по OSC

Кто Зачем
TouchOSC, Open Stage Control Планшет как пульт
Bitfocus Companion + Stream Deck Физические кнопки шоу
Звуковые пульты Уровни, мьюты, сцены — например, X32
Световые консоли Триггеры и обратная связь — Связка с пультом
Другие машины TouchDesigner Синхронизация состояния
QLab, Ableton, Resolume Шоу-контроль

Двусторонняя связь

Односторонний OSC ненадёжен: вы не знаете, дошло ли. Практика для шоу:

  1. TouchDesigner подтверждает приём: /ack/scene 3.
  2. Раз в секунду шлёт «я жив» с текущим состоянием.
  3. Пульт показывает состояние из этих сообщений, а не то, что сам отправил.

Так оператор видит реальность, а не свои намерения.

UDP теряет пакеты

OSC поверх UDP не гарантирует доставку. Импульс («следующая сцена») может пропасть. Для критичных вещей передавайте состояние, а не событие: не «next», а «сейчас сцена 4» — повторное сообщение с тем же значением безвредно.

Проверяйте вход отдельным окном

OSC In DAT без фильтров показывает всё, что приходит. Держите его в служебной панели: сразу видно, идут ли сообщения вообще и как выглядят адреса. Это снимает половину вопросов «у нас не работает» — остальное разбирается в Не приходит по сети.

Пульт вместо планшета

Если на площадке уже есть световая консоль и сеть Art-Net, управление часто дешевле отдать ей, а не строить OSC — Управление с светового пульта.

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