Controlar HeavyM con un móvil o tablet vía OSC [⭐ Pro]

⭐ Este artículo gira en torno a una función Pro .

Este tutorial está diseñado para ayudarte a entender cómo usar el protocolo OSC, con el fin de controlar HeavyM desde un dispositivo o aplicación inalámbrica remota.

En esta guía, nos centraremos principalmente en cómo controlar HeavyM desde una aplicación iOS o Android, con herramientas que permiten una configuración rápida y fácil. Pero sepan que hay muchas más conexiones posibles a través de OSC: por ejemplo, también permite usar la aplicación de secuenciador basada en línea de tiempo Vezér, o la máquina modular Chataigne.

¿Qué es OSC?

OSC es el acrónimo de “Open Sound Control” . Es un protocolo que se utiliza para la comunicación entre dispositivos multimedia que es similar al protocolo MIDI, pero permite la transferencia de datos más grandes, más rápida y a través de redes como Wifi y Ethernet. En resumen, este protocolo te permitirá controlar de forma remota algunas características en HeavyM. La gran noticia es que no es necesario conectar todo con kilómetros de cable, tus dispositivos solo necesitan estar en la misma red.

¡Esto abre infinitas posibilidades para instalaciones interactivas!

Encontrar una disposición

Dado que no estarás utilizando HeavyM directamente en tu smartphone, necesitas usar una aplicación con un diseño especial para tener una interfaz de usuario funcional, con deslizadores y botones. Hay muchas aplicaciones que te permiten construir estos paneles de control o tienen plantillas de diseño. Aquí tienes un ejemplo de un diseño en TouchOSC: 

Tienes dos opciones para conseguir un diseño:

Opción 1: Construir un diseño desde cero

Aquí no entraremos en detalles sobre cómo crear un diseño, pero puedes encontrar muchos recursos en internet sobre el tema. Si tienes las habilidades y eres valiente, puedes codificarlo, o puedes usar un editor WYSIWYG, como TouchOSC o el Lemur Editor. En estos casos, los editores son gratuitos para instalar en una computadora, pero los diseños que crees solo funcionarán con las aplicaciones asociadas que compres en la tienda de aplicaciones. (¡Por lo general, también puedes construir un diseño directamente desde la aplicación móvil o de tablet!)

Construir un diseño requiere crear los elementos de la interfaz de usuario, importar el diseño en la aplicación si lo construiste en una computadora y asignarles comandos de HeavyM. Para aprender cómo importar tu diseño, consulta el manual de la aplicación asociada.

Crear su propio diseño puede ser tedioso, pero obtendrá más control sobre cómo funciona cada elemento, qué información envía a HeavyM y cuándo, etc.

Opción 2: configurar una plantilla existente

Algunas aplicaciones te proporcionan plantillas de diseño. Eso significa que el primer paso está hecho: botones, deslizadores u otros elementos de la interfaz ya están organizados en pestañas, pero aún tienes que configurarlos. De hecho, estos elementos están "vacíos", no tienen ninguna asignación, por lo que aún no están vinculados a las funciones de HeavyM.

Usar un diseño preexistente sólo requiere asignar comandos de HeavyM a los elementos. 

⚠️ Si estás construyendo tu propia plantilla y mensajes, debes saber que HeavyM reacciona a argumentos de coma flotante entre 0,0 y 1,0 en mensajes OSC. Para los deslizadores, 0,0 representa el valor mínimo y 1,0 el máximo. Para los interruptores, 0,0 significa APAGADO y 1,0 significa ENCENDIDO.

Conectando TouchOSC y HeavyM

Los siguientes párrafos proporcionarán instrucciones específicas para ayudarte a configurar la aplicación TouchOSC y HeavyM. (Prometemos que no estamos patrocinados por esta app.)

Para seguir estas instrucciones, necesitas abrir HeavyM, TouchOSC y tener un diseño listo. Si estás usando otra aplicación, esto aún puede ayudarte ya que probablemente encontrarás muchas similitudes. De lo contrario, consulta el manual de la aplicación.

Nota: tus dispositivos necesitan estar conectados a la misma red para comunicarse, pero no necesariamente tiene que ser una conexión inalámbrica: por ejemplo, tu smartphone puede usar el Wifi y tu computadora puede usar Ethernet.

En TouchOSC

Nota: estas instrucciones describen el procedimiento a seguir con la versión iOS de la aplicación. La interfaz de Android es ligeramente diferente pero las acciones son similares, a menos que se indique lo contrario.

1. Primero, abre la configuración de Conexiones presionando el botón con el icono de eslabón de cadena en la barra de herramientas del editor, y ve a la pestaña "OSC".
   
2. Allí, en el campo de entrada "Host" de la primera Conexión, necesitas ingresar la dirección IP de tu computadora. Por lo general, puedes encontrarlo en Configuración o Preferencias del Sistema, en las propiedades de Red.
3. En los campos de entrada "Puerto de Envío" y "Puerto de Recepción", ingresa cualquier número entre 7 000 y 10 000. (Pero usa diferentes en ambos campos.)
4. Mantén esta pestaña abierta, ya que necesitarás información de allí, y dirígete a HeavyM.

En HeavyM

1. Abre la ventana de Configuración de Controles  desde Controles → Configuración de Controles... o  y ve a la pestaña "OSC". Asegúrate de que el Control OSC esté ACTIVADO con el interruptor en la parte superior.
2. Luego, en "Puerto de entrada", necesitas poner el número que pusiste en el campo "Puerto de envío" en TouchOSC. Inversamente, en "Puerto de salida", escribe el número que se indica en el campo "Puerto de recepción" en TouchOSC.
3. En "Dirección IP de salida", escribe la dirección IP de tu teléfono o tableta. Por lo general, se puede encontrar en la configuración de Red, o algunas aplicaciones OSC a veces lo muestran directamente.

Ahora, vuelve a tu diseño y sigue la siguiente sección de este tutorial para aprender cómo conectar sus elementos a los comandos de HeavyM.

Nota: si tienes problemas después de seguir estas instrucciones, puedes consultar la documentación de TouchOSC en su sitio web, es bastante completa y describe procedimientos con dispositivos iOS, así como otras características avanzadas de la aplicación.

Gestión de Asignaciones

Habilitando el Aprendizaje de OSC

Una vez que tu conexión esté configurada, puedes comenzar a asignar botones, faders, pads y todo lo que tu diseño contenga a los comandos en HeavyM. Para hacerlo, tienes que hacer que los elementos en la interfaz del software "aprendan" a cuál elemento en tu diseño OSC deben reaccionar.

Para eso, necesitas alternar la interfaz de Aprendizaje de OSC desde la ventana Controles (botón del "modo de aprendizaje de OSC") o menú (Controles → Editar Asignaciones de OSC). Aparecerá una superposición de color sobre los elementos que puedes mapear en la interfaz.

Añadiendo asignaciones

Selecciona un elemento de superposición con tu ratón o trackpad (estará rodeado en amarillo) y simplemente mueve o activa el elemento de control en tu diseño OSC que quieres usar con él. Esto asociará los controles de OSC e interfaz juntos y lo verás aparecer en la lista en la ventana de configuración de Controles.

Una vez que hayas terminado, puedes simplemente desactivar el modo de aprendizaje con el mismo botón/menú o con [Esc].

Nota: puedes asignar el mismo elemento del diseño OSC a varios comandos al mismo tiempo. Por ejemplo, un solo botón en tu dispositivo puede estar vinculado a múltiples conmutadores de efectos, ¡de modo que cuando lo presiones, todos estos efectos se activen a la vez!

⚠️ Si estás construyendo tu propia plantilla y mensajes, ten en cuenta que HeavyM reacciona a argumentos flotantes entre 0,0 y 1,0 en mensajes OSC. Para los deslizadores, 0,0 representa el valor mínimo y 1,0 el máximo. Para los conmutadores, 0,0 significa APAGADO y 1,0 significa ENCENDIDO.

Editando asignaciones

Para editar las asignaciones, simplemente active nuevamente el modo de aprendizaje. Luego, simplemente seleccione la asignación deseada y active el nuevo control OSC que desea usar.

Eliminación de asignaciones

Existen 3 posibilidades para eliminar asignaciones:

• Cuando el Modo de Aprendizaje está ACTIVADO, seleccione una superposición y presione [Eliminar/Retroceso]. Esto eliminará la asignación seleccionada.
• Haga clic derecho en una asignación individual en la tabla en la ventana de Controles y haga clic en la opción "Eliminar asignación". Esto eliminará la asignación seleccionada.
  
• Use el botón "Eliminar todas las asignaciones" sobre la tabla en la ventana de Controles. Esto eliminará todas las asignaciones OSC en el proyecto.
  
  
  

Guardado de asignaciones

Las asignaciones OSC que configure se guardan directamente en su archivo de proyecto .hm.

Configuración de asignaciones

Cada asignación que configure tiene un conjunto de configuraciones, como puede ver en la tabla de asignaciones de la ventana Controles.

Para las asignaciones OSC, puede editar:

• El Rango: esta configuración aparece en deslizadores o cuadros giratorios, por ejemplo. Al establecer un mínimo y un máximo, puede anular el rango del elemento de interfaz en HeavyM. Por ejemplo, si establece el rango de 1 a 15 para el grosor del efecto de borde, cuando mueva el fader que le ha asignado, los valores solo variarán entre 1 y 15 sin importar cuánto mueva su fader!