Integração com vMix

Envie legendas ao vivo para o vMix em produções de transmissão.

Visão Geral

Envie legendas em tempo real para o vMix em produções de transmissão. A Maestra roda no mesmo computador que o vMix e envia suas legendas ao vivo para uma entrada de título do vMix.

Antes de começar

• Use o Google Chrome e mantenha-o atualizado para a versão mais recente.
• Certifique-se de que o vMix esteja em execução e que o vMix Web Controller esteja ativado.
• Abra o Maestra no mesmo navegador, na mesma máquina que o vMix.

Como configurar

1. O vMix deve estar sendo executado no mesmo computador em que o Maestra Live está rodando.
2. Baixe este modelo de título que exibirá as legendas no vMix. Importe-o no vMix em Adicionar Entrada > Título/XAML. No canto superior direito da janela Selecionar Entrada, clique em Procurar... e selecione o arquivo de modelo de título baixado. Clique em OK.
3. No vMix, vá em Configurações > Controlador Web e marque a caixa para ativar o controlador web.
4. Defina a porta ou aceite o padrão.
5. Copie o "Endereço do Site Web vMix" e cole-o na Maestra.
6. Opcionalmente, baixe o Aplicativo Companion da Maestra para uma experiência mais integrada. Após instalar e executar, ative-o nas configurações do canal vMix, atualize a página e aproveite as legendas no vMix.

Solução de problemas

Se as legendas não estiverem chegando ao vMix a partir da sua sessão em tempo real do Maestra, siga esta lista de verificação na ordem indicada. Cada etapa elimina uma causa comum, desde as configurações do Web Controller e as permissões de rede do Chrome até firewalls, portas e o modelo de legenda do vMix. Pare assim que as legendas começarem a ser atualizadas na tela.

Lista de verificação

1. Confirme o básico
   • Execute o vMix Web Controller na mesma máquina que o navegador que usa o Maestra.
   • Certifique-se de que o canal aponte para a URL correta do vMix (padrão http://localhost:8088) e que o título da legenda ou o GUID do modelo corresponda.
2. Revise as opções de segurança do Web Controller
   • Mantenha Allow software on this computer access without login marcado.
   • Deixe Enable enhanced security on Web and TCP API desmarcado.
   • Deixe Restrict access to LAN only desmarcado.
3. Ative o acesso à rede local no Chrome
   • Acesse chrome://settings/content/all e, em seguida, pesquise e selecione live.maestra.ai (ou use o cadeado e depois Configurações do site).
   • Defina Acesso à rede local como Permitir, recarregue o Maestra e tente novamente.
4. Verifique a acessibilidade da rede
   • Nessa máquina, abra a URL do Web Controller (por exemplo http://localhost:8088) em qualquer navegador.
   • Se não carregar ou estiver lento, corrija isso primeiro: inicie o vMix, corrija a porta e desbloqueie os firewalls.
5. Tente uma porta diferente
   • Se 8088 continuar falhando, altere o vMix Web Controller para uma porta alta não utilizada (por exemplo 2025), atualize a URL no Maestra e teste novamente.
   • Isso muitas vezes contorna filtros de segurança corporativos ou listeners obsoletos vinculados a portas comuns.
6. Descarte bloqueios corporativos ou de VPN
   • Desconecte temporariamente VPNs, firewalls de endpoint ou antivírus que possam impedir que páginas HTTPS alcancem http://localhost.
   • Se as legendas começarem a funcionar, adicione o vMix e o navegador à lista de permitidos e reative as ferramentas de segurança.
7. Valide o modelo do vMix
   • No Title Designer, certifique-se de que o campo WebCaptionerCaptions exista e que o GUID corresponda às configurações do Maestra.
   • Edite o campo manualmente no vMix para confirmar se ele é atualizado na tela.
8. Inspecione o navegador
   • Abra o DevTools, depois a aba Network, ative o canal e observe a requisição SetText.
   • Observe se o navegador sinaliza Mixed Content, Private Network Access ou CORS, ou se a requisição nunca é enviada.
9. Resolva avisos de conteúdo misto ou de rede privada
   • Chrome, Edge ou Brave: desative chrome://flags/#block-insecure-private-network-requests e, em seguida, reinicie.
   • Safari: ative Develop e, em seguida, Disable Cross-Origin Restrictions durante o teste.
   • Firefox: defina network.websocket.allowInsecureFromHTTPS como true e certifique-se de que o modo somente HTTPS esteja desativado.
10. Monitore os resultados
    • Mantenha o DevTools aberto enquanto as legendas estão em execução. Se as requisições parecerem bem-sucedidas, mas o texto não for atualizado, capture telas da entrada na aba Network e da prévia do vMix.
    • Reúna o carimbo de data/hora, a versão do navegador, o sistema operacional e quaisquer erros do console antes de escalar para o suporte.

Ainda com problemas?

Artigos relacionados

• Integração com Zoom
• Integração com Microsoft Teams
• Integração com OBS Studio
• Integração com Google Meet