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

O vMix deve estar sendo executado no mesmo computador em que o Maestra Live está rodando.
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.
No vMix, vá em Configurações > Controlador Web e marque a caixa para ativar o controlador web.
Defina a porta ou aceite o padrão.
Copie o "Endereço do Site Web vMix" e cole-o na Maestra.
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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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?

Se as legendas ainda não forem atualizadas após esta lista de verificação, abra o widget de suporte no aplicativo e clique em Criar um chamado. Inclua o carimbo de data/hora, a versão do seu navegador, o sistema operacional, a versão do vMix e quaisquer erros do console.