Управление HeavyM с мобильного телефона или планшета через OSC [⭐ Pro]

⭐ Эта статья посвящена функции Pro.

Этот учебник предназначен для того, чтобы помочь вам понять, как использовать протокол OSC, чтобы управлять HeavyM с удалённого беспроводного устройства или приложения.

В этом руководстве мы в основном сосредоточимся на том, как управлять HeavyM из приложения на iOS или Android, с помощью инструментов, которые позволяют быструю и простую настройку. Но знайте, что через OSC возможно многие другие соединения: например, он также позволяет использовать приложение-секвенсор на базе временной шкалы Vezér, или модульную машину Chataigne.

Что такое OSC?

OSC это аббревиатура от “Open Sound Control”. Это протокол, который используется для связи между мультимедийными устройствами, похожий на MIDI-протокол, но он позволяет передавать большие объемы данных быстрее и через сети, такие как WiFi и Ethernet. Короче говоря, этот протокол позволит вам удаленно управлять некоторыми функциями HeavyM. Хорошая новость заключается в том, что нет необходимости соединять всё километрами кабеля, ваши устройства должны просто находиться в одной сети.

Это открывает бесконечные возможности для интерактивных инсталляций!

Поиск макета

Так как вы не будете использовать HeavyM непосредственно на вашем смартфоне, вам нужно использовать приложение со специальным макетом, чтобы иметь функциональный пользовательский интерфейс с ползунками и кнопками. Есть много приложений, которые позволяют создавать панели управления или используют шаблоны макетов. Вот пример макета в TouchOSC: 

У вас есть два варианта получения макета:

Вариант 1: создать макет с нуля

Мы не будем вдаваться в детали о том, как создавать макет здесь, но вы можете найти множество ресурсов по этой теме в интернете. Если у вас есть навыки и смелость, вы можете закодировать это, или вы можете использовать WYSIWYG-редактор, как TouchOSC, или Lemur Editor. В этих случаях редакторы можно бесплатно установить на компьютер, но созданные вами макеты будут работать только с ассоциированными приложениями, которые покупаются в App Store. (Вы можете также обычно создавать макеты прямо из мобильного приложения или приложения для планшета!)

Создание макета требует создания элементов пользовательского интерфейса, импорта макета в приложение, если оно было создано на компьютере, и назначения им команд HeavyM. Чтобы узнать, как импортировать ваш макет, пожалуйста, обратитесь к руководству по использованию соответствующего приложения.

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

Вариант 2: настройка существующего шаблона

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

Использование предварительно существующего макета требует только назначения команд HeavyM элементам. 

⚠️ Если вы создаете свой собственный шаблон и сообщения, имейте в виду, что HeavyM реагирует на аргументы с плавающей точкой от 0,0 до 1,0 в сообщениях OSC. Для слайдеров 0,0 представляет минимальное значение, а 1,0 — максимальное. Для переключателей 0,0 обозначает ВЫКЛ., а 1,0 обозначает ВКЛ.

Подключение TouchOSC и HeavyM

Следующие параграфы дадут конкретные инструкции, которые помогут вам настроить приложение TouchOSC и HeavyM. (Обещаем, мы не спонсированы этим приложением.)

Для выполнения этих инструкций, вам нужно открыть HeavyM, TouchOSC и подготовить макет. Если вы используете другое приложение, это все равно может помочь, поскольку вы, вероятно, найдете много сходств. В противном случае, пожалуйста, обратитесь к руководству по приложению.

Примечание: ваши устройства должны быть подключены к одной и той же сети для связи, но это необязательно должно быть беспроводное соединение: например, ваш смартфон может использовать WiFi, а ваш компьютер может использовать Ethernet.

В TouchOSC

Примечание: эти инструкции описывают процедуру для версии приложения под iOS. Интерфейс Android несколько отличается, но действия аналогичны, если не указано иное.

1. Сначала откройте настройки Подключения, нажав на кнопку с иконкой цепочки в панели инструментов редактора, и перейдите на вкладку «OSC».
   
2. Там, в поле ввода "Host" первого подключения, вам нужно ввести IP-адрес вашего компьютера. Вы обычно можете найти его в Настройки или Системные настройки, в свойствах Сети.
3. В полях ввода "Send Port" и "Receive Port" введите любое число от 7 000 до 10 000. (Но используйте разные в обоих полях.)
4. Держите эту вкладку открытой, так как вам понадобится информация оттуда, и перейдите к HeavyM.

В HeavyM

1. Откройте окно Настройки управления из Управление → Настройки управления... или  и перейдите на вкладку "OSC". Убедитесь, что OSC Управление в ВКЛ с переключателем вверху.
2. Затем, в «Входящий порт», нужно ввести число, которое вы указали в поле «Send Port» в TouchOSC. Наоборот, в «Исходящий порт», введите номер, указанный в поле «Receive Port» в TouchOSC.
3. В «Выходной IP-адрес», введите IP-адрес вашего телефона или планшета. Обычно вы можете найти его в настройках Сети, или некоторые приложения OSC иногда отображают его напрямую.

Теперь вернитесь к своей раскладке и следуйте следующему разделу этого руководства, чтобы узнать, как подключить его элементы к командам HeavyM.

Примечание:   если у вас возникли проблемы после выполнения этих инструкций, вы можете проконсультироваться с документацией TouchOSC на их сайте, она весьма подробна и описывает процедуры с устройствами iOS, а также другие расширенные функции в приложении.

Управление назначениями

Включение обучения OSC

После настройки подключения, вы можете начать назначать кнопки, фейдеры, панели и любые элементы вашего макета командам в HeavyM. Для этого нужно сделать так, чтобы элементы интерфейса программы "изучили", на какой объект в вашем макете OSC они должны реагировать.

Для этого необходимо переключить интерфейс обучения OSC через окно Управление (кнопка "режим обучения OSC"   ) или меню ( Управление →   Редактировать назначения OSC ). На элементы, которые можно сопоставить в интерфейсе, появится цветное наложение.

Добавление назначений

Выберите элемент наложения с помощью мыши или трекпада (он будет окружен желтым) и просто переместите или нажмите элемент управления на вашем макете OSC, который вы хотите использовать с ним. Это создаст ассоциацию между элементами управления OSC и интерфейсом, и вы увидите это в списке в окне настроек Управление.

Когда закончите, просто отключите режим обучения с помощью той же кнопки/меню или нажмите [Esc].

Примечание: вы можете назначить один и тот же элемент макета OSC нескольким командам одновременно. Например, одна кнопка на вашем устройстве может быть связана с несколькими переключателями эффектов, так что когда вы нажмете ее, все эти эффекты включатся одновременно!

⚠️ Если вы создаете свой собственный шаблон и сообщения, учтите, что HeavyM реагирует на аргументы с плавающей точкой от 0.0 до 1.0 в OSC-сообщениях. Для ползунков 0.0 представляет минимальное значение, а 1.0 - максимальное. Для переключателей 0.0 означает ВЫКЛ и 1.0 - ВКЛ.

Редактирование назначений

Чтобы редактировать назначения, просто снова включите режим обучения. Затем просто выберите нужное назначение и активируйте новый элемент управления OSC, который вы хотите использовать.

Удаление назначений

Существует 3 варианта удаления назначений:

• Когда режим обучения включен, выберите наложение и нажмите [Удалить/Назад]. Это удалит выбранное назначение.
• Кликните правой кнопкой мыши по отдельному назначению в таблице в окне Управление и выберите опцию "Удалить назначение". Это удалит выбранное назначение.
  
• Используйте кнопку "Удалить все назначения" над таблицей в окне Управление. Это удалит все назначения OSC в проекте.
  
  
  

Сохранение назначений

Назначения OSC, которые вы установили, сохраняются непосредственно в вашем файле проекта .hm.

Настройки назначения

Каждое конфигурируемое вами назначение имеет набор настроек, как вы можете видеть в таблице назначений окна Управление.

Для назначений OSC вы можете редактировать:

• Диапазон: эта настройка появляется, например, на ползунках или спинбоксах. Настраивая Min и Max, вы можете изменить диапазон элемента интерфейса в HeavyM. Например, если вы установите диапазон от 1 до 15 для толщины эффекта границы, когда вы перемещаете фейдер, назначенный ему, значения будут изменяться только между 1 и 15, вне зависимости от того, как сильно вы перемещаете фейдер!