Como Configurar os Mixers de Vídeo (OBS, ATEM, vMix, Companion e outros) no NEOiD Tally HUB
1️⃣ Introdução
O NEOiD Tally HUB oferece suporte nativo à integração com diversos mixers de vídeo profissionais, permitindo a identificação automática dos estados Program e Preview das câmeras e cenas. Este manual descreve, de forma detalhada e operacional, como configurar cada mixer suportado, incluindo requisitos, parâmetros de conexão, mapeamento de canais e procedimentos de verificação.
Este documento deve ser utilizado em conjunto com os manuais de Instalação do NEOiD Tally HUB e Configuração Inicial do NEOiD Tally HUB.
2️⃣ Mixers de Vídeo Suportados
O NEOiD Tally HUB é compatível com os seguintes mixers:
-
Blackmagic ATEM — Protocolo via TCP
-
vMix — API TCP/HTTP
-
OBS Studio — WebSocket (obs-websocket v5)
-
Bitfocus Companion — Satellite Protocol
-
Roland V-60HD — Protocolo proprietário (Beta)
Observação: Cada mixer utiliza uma porta padrão e um protocolo específico, que devem estar liberados no firewall.
3️⃣ Blackmagic ATEM
3.1 Requisitos
Para integração com mixers Blackmagic ATEM, é necessário:
-
Switcher ATEM compatível (ATEM Mini, Mini Pro, Television Studio, Production Studio, etc.)
-
Conexão Ethernet ativa entre o ATEM e o computador do HUB
-
Endereço IP configurado no ATEM
3.2 Descobrir o Endereço IP do ATEM
O endereço IP do ATEM pode ser obtido de três formas:
Opção 1 — ATEM Software Control
Abra o ATEM Software Control, acesse Preferences → Network e anote o campo IP Address.
Opção 2 — ATEM Setup (via USB)
Conecte o ATEM ao computador via USB, abra o ATEM Setup, acesse Network e anote o endereço IP configurado.
Opção 3 — Varredura de Rede
É possível localizar o ATEM realizando um scan de rede a partir do computador.
3.3 Configuração no NEOiD Tally HUB
Na interface web do HUB:
-
Acesse o menu Mixer
-
Clique em Select Mixer
-
Selecione Blackmagic ATEM
-
Informe:
-
IP Address: IP do ATEM (ex.:
192.168.1.100) -
Port: 9910 (padrão — não alterar)
-
-
Clique em Save
3.4 Verificação de Conexão
Quando a conexão for bem-sucedida, o HUB exibirá logs indicando:
-
Conexão estabelecida com o ATEM
-
Modelo do switcher
-
Quantidade de inputs disponíveis
O status do mixer deverá aparecer como Connected.
3.5 Mapeamento de Canais (ATEM)
O ATEM utiliza índices baseados em zero, porém o NEOiD Tally HUB trabalha com canais iniciando em 1.
Dessa forma:
-
Input 1 do ATEM → Channel 1 no HUB
-
Input 2 do ATEM → Channel 2 no HUB
-
E assim sucessivamente
Os nomes das câmeras podem ser configurados no ATEM Software Control ou ajustados manualmente no HUB.
3.6 Troubleshooting — ATEM
Se o HUB não conectar ao ATEM:
-
Verifique conectividade com ping
-
Confirme se a porta 9910 está liberada no firewall
-
Reinicie o ATEM, se necessário
Observação: Latência de até 200 ms na atualização do tally pode ser normal, dependendo da rede.
4️⃣ vMix
4.1 Requisitos
-
vMix versão 20 ou superior
-
vMix em execução no computador local ou na rede
-
API Web habilitada no vMix
4.2 Habilitar API no vMix
No vMix:
-
Acesse Settings → Web Controller
-
Ative Enable TCP API
-
Anote o IP e a porta (padrão: 8099)
4.3 Configuração no HUB
-
Acesse Mixer → Select Mixer
-
Escolha vMix
-
Informe:
-
IP Address do computador com vMix
-
Port: 8099
-
-
Clique em Save
4.4 Mapeamento de Canais (vMix)
O vMix utiliza inputs numerados a partir de 1. Cada input corresponde diretamente a um canal no HUB.
Os nomes configurados no vMix são sincronizados automaticamente com o HUB.
4.5 Troubleshooting — vMix
Se o HUB não conectar:
-
Verifique se a API está habilitada
-
Confirme liberação da porta 8099 no firewall
-
Verifique o IP configurado
Observação: A atualização do tally ocorre após a conclusão das transições no vMix, o que pode ser comportamento normal.
5️⃣ OBS Studio
5.1 Requisitos
-
OBS Studio versão 28 ou superior
-
obs-websocket 5.0 ou superior (incluído por padrão no OBS 28+)
5.2 Configurar obs-websocket
No OBS Studio:
-
Acesse Tools → WebSocket Server Settings
-
Ative Enable WebSocket server
-
Configure a porta (padrão: 4455)
-
Ative autenticação e defina uma senha (recomendado)
5.3 Configuração no HUB
-
Acesse Mixer → Select Mixer
-
Escolha OBS Studio
-
Informe:
-
IP Address do computador com OBS
-
Port: 4455
-
Password (se configurada)
-
-
Clique em Save
5.4 Mapeamento de Canais (OBS)
No OBS, o HUB mapeia Scenes para canais:
-
Scene 1 → Channel 1
-
Scene 2 → Channel 2
O estado Preview só é detectado quando o Studio Mode está habilitado no OBS.
5.5 Troubleshooting — OBS
-
Verifique se o WebSocket está ativo
-
Confirme senha e porta configuradas
-
Habilite Studio Mode para detecção de Preview
6️⃣ Bitfocus Companion
6.1 Arquitetura de Integração
A integração com o Bitfocus Companion utiliza o protocolo Satellite, onde o NEOiD Tally HUB atua como um dispositivo virtual monitorando o estado visual dos botões do Stream Deck.
6.2 Configuração no Companion
No Companion:
-
Certifique-se de que o Satellite API está habilitado
-
Anote a porta Satellite (padrão: 16622)
6.3 Configuração no HUB
No HUB:
-
Acesse Mixer → Select Mixer
-
Escolha Companion Satellite
-
Configure:
-
IP
-
Port
-
Device ID
-
Columns
-
Rows
-
-
Clique em Save
6.4 Mapeamento de Botões
Os botões do Stream Deck são mapeados sequencialmente:
-
Botão 0 → Tally 1
-
Botão 1 → Tally 2
A detecção do estado é baseada na cor de fundo do botão (HSV).
6.5 Troubleshooting — Companion
-
Verifique se o HUB aparece em Surfaces
-
Libere a porta 16622 no firewall
-
Utilize cores saturadas (vermelho e verde puros) para melhor detecção
7️⃣ Roland V-60HD (Beta)
7.1 Status Beta
O suporte ao Roland V-60HD encontra-se em fase de testes e pode apresentar instabilidades.
7.2 Configuração
-
No Roland, habilite o controle via rede
-
Anote o IP configurado
-
No HUB, selecione Roland V-60HD
-
Informe:
-
IP
-
Port: 80
-
-
Clique em Save e verifique a conexão
8️⃣ Troca de Mixer
Para alterar o mixer configurado:
-
Acesse Mixer → Select Mixer
-
Escolha o novo mixer
-
Configure os parâmetros
-
Clique em Save
A conexão anterior será encerrada automaticamente, mas os tallies permanecerão configurados.