Controladores MIDI

Os Controladores MIDI permitem comandar o WAVESampler por uma superfície física e, quando o equipamento oferece esse recurso, receber de volta iluminação e outros sinais de estado. A entrada MIDI leva botões, pads e controles até o programa; a saída MIDI devolve feedback visual; e o mapeamento traduz cada mensagem para uma ação do sampler.

Como a integração MIDI funciona?

A configuração combina três elementos independentes: um dispositivo de entrada (MIDI IN), um dispositivo de saída (MIDI OUT) e um arquivo de mapeamento compatível. Em um uso completo, o fluxo é:

1. ative o suporte na seção Interface MIDI;
2. selecione o dispositivo de entrada e clique em Conectar;
3. selecione o dispositivo de saída e conecte-o, se o controlador usar iluminação ou outro feedback;
4. escolha um mapeamento compatível com o equipamento.

Interface MIDI

A opção Ativar suporte a controladores liga ou desliga a integração MIDI do WAVESampler. Ao abrir essa página pela primeira vez, o programa prepara o sistema e procura dispositivos e mapas disponíveis, mas não abre portas MIDI automaticamente.

Dispositivo de entrada (MIDI IN)

O MIDI IN recebe os comandos enviados pelo controlador. É por ele que pads, botões, encoders, faders e outros controles chegam ao WAVESampler. Selecionar um dispositivo apenas define qual equipamento será usado; a porta é aberta somente depois de clicar em Conectar.

• Seleção: escolha a porta pela qual o controlador envia suas mensagens. Em equipamentos com mais de uma porta, prefira a porta MIDI regular indicada pelo mapa instalado.
• Status: a linha abaixo da lista informa se a porta está fechada, conectada ou indisponível.
• Conectar: abre somente a entrada selecionada. Ativar a interface ou conectar o cabo não abre a porta automaticamente.
• Desconectar ou tentar novamente: libera a entrada atual ou repete a abertura depois de uma falha, sem interferir no MIDI OUT.

Uma configuração apenas com MIDI IN é válida: os comandos podem controlar o WAVESampler mesmo sem iluminação ou retorno de estado no equipamento.

Dispositivo de saída (MIDI OUT)

O MIDI OUT envia informações do WAVESampler de volta ao controlador, como acendimento de pads, estados ligados ou desligados, brilho, cores e outras respostas previstas pelo equipamento. A saída é independente da entrada: você pode reconectar uma delas sem afetar a outra. Se o controlador não usa feedback, a saída pode permanecer desconectada.

• Quando configurar: selecione uma saída quando o mapa usa LEDs, anéis luminosos, displays ou mensagens de inicialização do dispositivo.
• Porta correta: controladores podem expor saídas MIDI, DAW e DIN separadas. Use a saída reconhecida pelo mapa, sem presumir que o nome mais parecido com a entrada é o par correto.
• Conexão independente: conectar, desconectar ou recuperar o MIDI OUT não interrompe a entrada já aberta.
• Sem feedback: se os comandos funcionam, mas as luzes não respondem, verifique a saída selecionada, a conexão e os recursos declarados pelo mapa.

Mapeamento do controlador

O mapeamento é um arquivo JSON que descreve o controlador, suas capacidades e a relação entre mensagens MIDI e ações do WAVESampler. Ele também define o tipo de feedback disponível. O programa apresenta somente os mapas compatíveis com os dispositivos escolhidos e impede a execução de mapas inválidos ou incompletos.

A compatibilidade considera separadamente os nomes de MIDI IN e MIDI OUT. O mapa precisa corresponder a todos os dispositivos selecionados; por isso, trocar uma porta pode alterar imediatamente as opções disponíveis na lista de mapeamentos.

• Mapa disponível: selecione-o para ativar as associações entre controles físicos e ações do WAVESampler.
• Nenhum mapa compatível disponível: os endpoints escolhidos não correspondem a um mapa instalado, ou nenhuma porta necessária foi selecionada.
• Mapa inválido: arquivos incompletos podem aparecer para diagnóstico, mas não são executados parcialmente nem substituem silenciosamente o mapa ativo.

Para criar, adaptar ou distribuir mapas JSON, consulte a documentação dedicada: SDK MIDI do WAVESampler.

O que pode ser controlado?

• Sampler: acionamento e parada de samples, replay e outras ações de performance.
• Mixer: volume, pitch, panorama e estados de canais ou do master.
• Playlist: reprodução, navegação e comandos associados ao fluxo da lista.
• Feedback: estados simples, brilho, paleta indexada, RGB ou mensagens específicas do dispositivo, conforme o mapa.

Conexão manual e reconexão

Conectar um equipamento é sempre uma ação explícita. Selecionar outro dispositivo, ativar o suporte MIDI ou conectar o cabo durante a execução não abre a porta sozinho. Use Conectar ou Tentar novamente quando quiser iniciar a comunicação; use Desconectar para liberar apenas a porta correspondente.

Soluções rápidas

• Nenhum dispositivo aparece: confirme o cabo, a alimentação e o driver do equipamento. Reconecte-o e volte à página para atualizar a lista.
• Os comandos chegam, mas as luzes não respondem: configure e conecte também o MIDI OUT e use um mapa que ofereça feedback.
• Não há mapa compatível: verifique se o arquivo JSON identifica corretamente o controlador e se está na pasta de mapas MIDI usada pelo WAVESampler.
• A conexão falhou: feche outros programas que possam estar usando a mesma porta e clique em Tentar novamente.

Resumo

Em Controladores MIDI, o MIDI IN recebe comandos, o MIDI OUT devolve feedback e o mapeamento converte as mensagens em ações do WAVESampler. As conexões são manuais e independentes, o que torna a configuração previsível e facilita a recuperação de cada porta sem interferir na outra.