Painel

Como configurar e testar a reprodução WebRTC

Prepare vídeo de baixa latência para o navegador e valide o percurso real do evento, do encoder aos dispositivos da sua audiência.

O que este adicional habilita

WebRTC é oferecido como saída de reprodução no navegador por USD 20/mês por canal, além do plano de vídeo. A publicação pode continuar por RTMP ou SRT e a URL HLS padrão permanece disponível. O adicional não inclui um aplicativo de lances, chat ou videoconferência.

A reprodução usa sinalização WebSocket (wss://) com um player compatível, como o OvenPlayer; não é um endpoint WHEP. A publicação continua chegando por RTMP ou SRT a partir do seu encoder.

1. Verifique a compatibilidade do canal

  • Você precisa de um plano de vídeo pago com o adicional WebRTC no canal. O plano grátis serve para validar encoder, conexão e player, mas não inclui WebRTC.
  • LL-HLS é um adicional à parte, de USD 20/mês por canal, com URL própria no painel.
  • Dimensione a transferência do plano conforme a audiência e a duração do evento.

Se o canal já estiver em uso, ative o WebRTC fora do horário de transmissão e teste a reprodução antes do ao vivo.

2. Publique um sinal de teste por RTMP ou SRT

  1. Copie do painel o endereço e as credenciais de ingestão correspondentes ao encoder.
  2. Envie um sinal com vídeo, áudio e um relógio visível, com o perfil de codecs indicado no painel.
  3. Confirme que o canal recebe o sinal. Verifique a carga de CPU do encoder, a continuidade do áudio e a estabilidade da rede antes de testar o navegador.

3. Conecte um player compatível

  1. Obtenha no painel a opção de reprodução WebRTC do canal. Se nenhum endereço ou configuração WebRTC aparecer, confirme a habilitação com o suporte.
  2. Use o player fornecido ou uma integração compatível com a sinalização do servidor. Mantenha o endereço e os parâmetros recebidos; não substitua WSS por HTTPS nem acrescente /whep.
  3. Abra o player em uma página HTTPS e em um navegador compatível. Teste primeiro com o usuário clicando para reproduzir: as políticas de autoplay podem bloquear o áudio.
  4. Se você configurou proteção de reprodução, preserve seus parâmetros de acesso. Não coloque a senha ou o token de publicação no player.

O WebRTC usa tráfego UDP além da sinalização: firewalls, VPNs e redes corporativas restritas podem bloqueá-lo. Se parte da sua audiência estiver em redes corporativas, teste a partir delas e ofereça o player HLS como alternativa.

4. Verifique latência e experiência de reprodução

  1. Valide imagem, áudio, sincronização e reconexão nos navegadores e celulares previstos para o evento.
  2. Compare o relógio visível na fonte com o vídeo recebido. Repita várias vezes e anote encoder, resolução, rede, dispositivo, navegador e horário.
  3. Diferencie o tempo de início do atraso durante a reprodução. Trocar de rede ou retomar uma aba pode produzir outra experiência.
  4. Ensaie com acessos simultâneos representativos; para um evento grande, dimensione a capacidade com um especialista.
  5. Tenha à mão o player HLS do canal como alternativa e defina como trocar para ele durante o evento.

Até 0,3 s é a latência de reprodução WebRTC em condições adequadas; captura, encoder, distância e a rede do espectador somam a sua parte.

Diagnóstico de problemas frequentes

SintomaO que verificar
A opção WebRTC não apareceSe o adicional WebRTC está ativo no canal.
O endereço retorna erro ou não iniciaURL atual do painel e player compatível com sinalização WebSocket. Não substitua por uma URL WHEP ou WHIP.
Conecta, mas não mostra vídeoSinal de entrada, codecs, negociação do player e acesso de rede ao tráfego de mídia. Compare outro navegador e outra rede.
Há imagem, mas não áudioFaixa de áudio, codec compatível, volume e políticas de autoplay. Tente clicar para reproduzir.
Funciona em uma rede e falha em outraFirewall, VPN e políticas da rede afetada. Informe ao suporte o tipo de rede e o erro; não desative permanentemente a segurança da rede como solução.
HLS funciona, mas WebRTC nãoWebRTC habilitado, configuração do player, codecs e requisitos de rede. Os protocolos usam percursos diferentes.

Para o suporte, reúna o identificador do canal, data e hora com fuso horário, navegador e sistema operacional, rede, encoder e descrição do erro. Oculte tokens e credenciais nos registros. Se o evento envolver lances ou decisões com prazo, o aplicativo deve gerenciar suas próprias confirmações; não as baseie apenas no atraso do vídeo.

Continue sua configuração