Controlar o HeavyM com um dispositivo móvel ou tablet via OSC [⭐ Pro]

⭐ Este artigo gira em torno de um recurso Pro .

Este tutorial destina-se a ajudá-lo a entender como usar o protocolo OSC, a fim de controlar o HeavyM a partir de um dispositivo ou aplicativo sem fio remoto.

Neste guia, vamos nos concentrar principalmente em como controlar o HeavyM a partir de um aplicativo iOS ou Android, com ferramentas que permitem uma configuração rápida e fácil. Mas saiba que há muitas mais conexões possíveis via OSC: por exemplo, ele também permite que você use o aplicativo sequenciador baseado em linha do tempo Vezér, ou a máquina modular Chataigne.

O que é OSC?

OSC é a sigla para “Open Sound Control”. É um protocolo usado para comunicação entre dispositivos multimídia, semelhante ao protocolo MIDI, mas permite a transferência de dados maiores, mais rapidamente, e através de redes como Wifi e Ethernet. Em resumo, este protocolo permitirá que você controle algumas funcionalidades do HeavyM remotamente. A grande notícia é que não há necessidade de conectar tudo com quilômetros de cabo, seus dispositivos só precisam estar na mesma rede.

Isso abre infinitas possibilidades para instalações interativas!

Encontrar um layout

Como você não usará o HeavyM diretamente no seu smartphone, precisa usar um aplicativo com um layout especial, para ter uma interface de usuário funcional, com deslizadores e botões. Há muitos aplicativos que permitem montar esses painéis de controle ou têm modelos de layout. Aqui está um exemplo de um layout no TouchOSC: 

Você tem duas opções para obter um layout:

Opção 1: construir um layout do zero

Não vamos entrar em detalhes sobre como criar um layout aqui, mas você pode encontrar muitos recursos na internet sobre o assunto. Se você tem habilidade e coragem, pode codificá-lo ou você pode usar um editor WYSIWYG, como o TouchOSC ou o Editor Lemur. Nesses casos, os editores são gratuitos para instalar em um computador, mas os layouts que você cria só funcionarão com os aplicativos associados que você compra na loja de aplicativos. (Você geralmente também pode construir um layout diretamente do aplicativo móvel ou tablet!)

A construção de um layout requer a criação dos elementos da interface do usuário, a importação do layout no aplicativo se você o criou em um computador e a atribuição de comandos HeavyM a eles. Para aprender como importar seu layout, consulte o manual do aplicativo associado.

Criar seu próprio layout pode ser trabalhoso, mas você terá mais controle sobre como cada elemento funciona, que informações enviam ao HeavyM e quando, etc.

Opção 2: configurar um modelo existente

Alguns aplicativos oferecem modelos de layout. Isso significa que o primeiro passo foi dado: botões, deslizadores ou outros elementos da interface já estão organizados em abas, mas você ainda precisa configurá-los. Na verdade, esses elementos estão “vazios”, não têm atribuição, então ainda não estão ligados aos recursos do HeavyM.

O uso de um layout pré-existente requer apenas a atribuição de comandos HeavyM aos elementos. 

⚠️ Se você está construindo seu próprio modelo e mensagens, saiba que o HeavyM reage a argumentos flutuantes entre 0,0 e 1,0 nas mensagens OSC. Para deslizadores, 0,0 representa o valor mínimo e 1,0 o máximo. Para alternar, 0,0 significa DESLIGADO e 1,0 significa LIGADO.

Conectando TouchOSC e HeavyM

Os próximos parágrafos fornecerão instruções específicas para ajudá-lo a configurar o aplicativo TouchOSC e o HeavyM. (Prometemos que não somos patrocinados por este aplicativo.)

Para seguir estas instruções, você precisa abrir HeavyM, TouchOSC e ter um layout pronto. Se você estiver usando outro aplicativo, isso ainda pode ajudá-lo, pois provavelmente encontrará muitas semelhanças. Caso contrário, consulte o manual do aplicativo.

Nota: seus dispositivos precisam estar conectados à mesma rede para se comunicar, mas não precisa ser necessariamente uma conexão sem fio: seu smartphone pode usar o Wifi e seu computador pode usar o Ethernet, por exemplo.

No TouchOSC

Nota: estas instruções descrevem o procedimento a seguir com a versão iOS do aplicativo. A interface Android é ligeiramente diferente, mas as ações são semelhantes, a menos que especificado de outra forma.

1. Primeiro, abra as configurações de Conexões pressionando o botão com o ícone de elo de corrente na barra de ferramentas do editor, e vá para a guia "OSC".
   
2. Lá, no campo de entrada de "Host" da primeira Conexão, você precisa inserir o endereço IP do seu computador. Você geralmente pode encontrá-lo em Configurações ou Preferências do Sistema, nas propriedades de Rede.
3. Nos campos de entrada "Porta de Envio" e "Porta de Recepção", insira qualquer número entre 7 000 e 10 000. (Mas use números diferentes em ambos os campos.)
4. Mantenha esta aba aberta, pois você precisará de informações de lá, e vá para o HeavyM.

No HeavyM

1. Abra a janela de Configurações de Controles a partir de Controles → Configurações de Controles... ou e vá para a guia "OSC". Certifique-se de que o Controle OSC está LIGADO com o botão de alternância na parte superior.
2. Em seguida, no "Porta de Entrada", você precisa colocar o número que colocou no campo "Porta de Envio" no TouchOSC. Inversamente, na "Porta de Saída", digite o número que está indicado no campo "Porta de Recepção" no TouchOSC.
3. Em "Endereço IP de Saída", digite o endereço IP do seu telefone ou tablet. Você geralmente pode encontrá-lo nas configurações de Rede, ou alguns aplicativos OSC às vezes o exibem diretamente.

Agora, volte para o seu layout e siga a próxima seção deste tutorial para aprender como conectar seus elementos aos comandos do HeavyM.

Nota: se você tiver problemas após seguir estas instruções, consulte a documentação TouchOSC no site. É bastante completa e descreve procedimentos com dispositivos iOS, bem como outros recursos avançados do aplicativo.

Gerenciando Atribuições

Habilitando Aprendizado OSC

Depois que sua conexão estiver configurada, você pode começar a atribuir botões, faders, pads e qualquer coisa que seu layout contenha aos comandos do HeavyM. Para fazer isso, você deve fazer com que os elementos na interface do software "aprendam" a que item em seu layout OSC eles devem reagir.

Para isso, você precisa alternar a interface de Aprendizado OSC a partir da janela de Controles (botão "modo de aprendizado OSC") ou menu (Controles → Editar Atribuições OSC). Uma sobreposição colorida aparecerá sobre os elementos que você pode mapear na interface.

Adicionando atribuições

Selecione um elemento sobreposto com seu mouse ou trackpad (ele estará circulado em amarelo) e apenas mova ou acione o item de controle em seu layout OSC que você deseja usar com ele. Isso irá associar o OSC e os controles da interface juntos e você o verá aparecer na lista na janela de configurações de Controles.

Depois de terminar, você pode simplesmente desligar o modo de aprendizado com o mesmo botão/menu ou com [Esc].

Nota: você pode atribuir o mesmo elemento de layout OSC a vários comandos ao mesmo tempo. Por exemplo, um único botão no seu dispositivo pode ser vinculado a vários alternadores de efeitos, para que quando você o acione, todos esses efeitos sejam ativados ao mesmo tempo!

⚠️ Se você está construindo seu próprio modelo e mensagens, saiba que HeavyM reage a argumentos flutuantes entre 0,0 e 1,0 em mensagens OSC. Para controles deslizantes, 0,0 representa o valor mínimo e 1,0 o máximo. Para alternadores, 0,0 significa DESLIGADO e 1,0 significa LIGADO.

Editando atribuições

Para editar as atribuições, basta ativar o modo de aprendizado novamente. Então, selecione simplesmente a atribuição desejada e acione o novo controle OSC que você deseja usar.

Excluindo atribuições

Existem 3 possibilidades para excluir atribuições:

• Quando o modo de aprendizado está LIGADO, selecione uma sobreposição e pressione [Excluir/Retrocesso]. Isso removerá a atribuição selecionada.
• Clique com o botão direito em uma única atribuição na tabela na janela de Controles e clique na opção "Excluir atribuição". Isso removerá a atribuição selecionada.
  
• Use o botão "Excluir todas as atribuições" acima da tabela na janela Controles. Isso removerá todas as atribuições OSC no projeto.
  
  
  

Salvando atribuições

As atribuições OSC que você configura são salvas diretamente no seu arquivo de projeto .hm.

Configurações de atribuições

Cada atribuição que você configura possui um conjunto de configurações, como você pode ver na tabela de atribuições da janela Controles.

Para atribuições OSC, você pode editar:

• O Intervalo: esta configuração aparece em controles deslizantes ou caixas de rotação, por exemplo. Ao definir um Mínimo e um Máximo, você pode substituir o intervalo do elemento da interface no HeavyM. Por exemplo, se você definir o intervalo de 1 a 15 para a Espessura do efeito de Borda, ao mover o fader que você atribuiu a ele, os valores variarão apenas entre 1 e 15, não importa o quanto você mova seu fader!