Corrigir problema de carregamento da webcam BigBlueButton: Falha na conexão do socket ICE

Quando a webcam do BigBlueButton permanece com a tela preta e o navegador ou a reunião exibe a mensagem “Falha na conexão do socket ICE”, isso indica uma falha na conexão de mídia, mas não identifica uma causa única. As permissões da câmera, a rede do usuário, o firewall do servidor, o endereçamento NAT e as configurações de retransmissão TURN podem ser relevantes. Comece verificando se o problema foi isolado antes de alterar a configuração do servidor.

O guia de solução de problemas atual do BigBlueButton descreve um erro relacionado, 1007: Falha na negociação ICE , como uma falha na negociação de um caminho entre o navegador e o servidor de mídia. Ele lista NAT, portas UDP bloqueadas e a possível necessidade de ativar o TURN em redes restritivas. A frase exata no seu navegador pode variar de acordo com a versão do BigBlueButton, a plataforma de hospedagem ou o cliente. Considere-a como uma pista, não como um diagnóstico. Leia o guia de solução de problemas do BigBlueButton 4.0 .

Primeiro, identifique se o problema está na câmera ou na conexão.

É necessário obter permissão para acessar a webcam pelo navegador, e a página da reunião deve usar um contexto seguro, como HTTPS. Essas verificações determinam se o navegador pode capturar vídeo local. O ICE é o processo do WebRTC que encontra uma rota de rede para o envio de mídia entre o navegador e o BigBlueButton. Uma negação de permissão para acessar a câmera e uma falha na rota ICE são problemas diferentes, embora ambos possam deixar a webcam indisponível. A MDN documenta os requisitos de permissão do navegador e de contexto seguro .

Verifique o ícone da câmera ao lado da barra de endereço e as configurações do site no navegador. Permita o acesso à câmera para o site BigBlueButton, confirme se a câmera desejada está selecionada e feche outros aplicativos que possam estar usando a câmera. Se o navegador exibir uma pré-visualização local, mas a reunião ainda não publicar o vídeo, o acesso local ao dispositivo provavelmente está funcionando; continue com as verificações de rede. Se nenhuma pré-visualização aparecer, verifique primeiro a seleção do dispositivo, as configurações de privacidade do sistema operacional ou as permissões do navegador.

Experimente estas verificações de participantes em ordem.

1. Recarregue a página e tente entrar novamente. Saia da reunião, recarregue a página, entre novamente e tente usar a webcam. Isso pode resolver um problema temporário do navegador ou da sessão de mídia, mas uma falha ICE repetida geralmente requer uma correção na rede ou no servidor.
2. Atualize ou mude para um navegador compatível. Experimente uma versão atual de outro navegador de desktop compatível. Se a webcam funcionar nesse navegador, anote o navegador e a versão originais para o anfitrião da reunião. Pode haver comportamentos específicos de cada navegador, portanto, um navegador funcionando corretamente não garante que o servidor esteja configurado corretamente para todos os usuários.
3. Compare com outra rede. Se permitido, conecte-se usando o ponto de acesso do seu celular ou outra rede confiável. O funcionamento correto da webcam na segunda conexão sugere fortemente que a rede Wi-Fi original, a VPN, o proxy ou o firewall corporativo está restringindo o tráfego de mídia. Isso não prova qual regra específica é a responsável.
4. Teste a mesma sala com outro participante. Se várias pessoas em redes diferentes não conseguirem publicar suas webcams, relate um possível problema de servidor ou hospedagem ao administrador da reunião. Se apenas uma pessoa apresentar problemas, concentre-se primeiro no dispositivo, navegador e rede desse participante.
5. Teste outra sala ou demonstração do BigBlueButton. Se sua organização permitir, use uma sala separada ou o serviço de teste oficial do BigBlueButton. Se a câmera funcionar lá, mas não no servidor da sua organização, compartilhe essa comparação com o administrador.

O que os administradores devem verificar

Quando vários usuários são afetados, verifique o caminho da mídia em cada limite de rede: o firewall do host, o grupo de segurança na nuvem, o roteador ou dispositivo NAT e qualquer firewall de rede upstream. A documentação do firewall do BigBlueButton lista as portas TCP 80 e 443 para tráfego web e, na configuração padrão documentada, as portas UDP 16384–32768 para mídia. Sua instalação pode usar um intervalo personalizado ou uma pilha de mídia específica da versão, portanto, confirme a configuração real antes de alterar as regras. Não abra um intervalo maior do que o necessário para a instalação. Consulte o guia de configuração do firewall do BigBlueButton .

Para um servidor atrás de um NAT, confirme se o serviço de mídia anuncia um endereço IP externo acessível. O BigBlueButton 2.5 e versões posteriores usam o mediasoup para mídia WebRTC HTML5; o guia oficial do firewall descreve a configuração do endereço externo anunciado em [link /etc/bigbluebutton/bbb-webrtc-sfu/production.ymlpara o guia]. Um endereço privado, um endereço público desatualizado, um encaminhamento de porta incorreto ou a ausência de configuração IPv6 podem impedir que os clientes acessem o serviço de mídia. Aplique somente as instruções que correspondem à sua versão do BigBlueButton e à sua configuração de rede e reinicie os serviços apenas conforme indicado no guia.

Verifique também se os usuários afetados estão em redes que bloqueiam UDP de saída. Um servidor TURN pode retransmitir o tráfego WebRTC quando uma rota direta não estiver disponível, mas ele deve estar instalado, acessível e configurado para a versão relevante do BigBlueButton. A documentação e as configurações padrão do pacote TURN variam entre as versões; siga o guia específico da versão que você está usando. Não copie credenciais ou configurações de porta de uma versão diferente. Consulte o guia do servidor TURN do BigBlueButton 4.0 .

Suposições comuns a evitar

“O erro na webcam significa que a câmera está com defeito.”

Não necessariamente. Se a pré-visualização local aparecer e o navegador tiver permissão, o dispositivo pode estar funcionando enquanto a rota de mídia falha. Ação: tente outra rede e verifique se outros participantes estão sendo afetados antes de substituir a câmera.

“Permitir que a câmera funcione resolve todos os problemas com webcams.”

A permissão permite apenas que o navegador capture vídeo. Ela não libera tráfego UDP bloqueado nem corrige o endereço NAT do servidor. Ação: após confirmar a permissão, teste a conexão a partir de outra rede.

“Uma reunião que carrega normalmente comprova que sua rede de mídia está aberta.”

A página e os controles da reunião podem ser carregados via HTTPS, mas o áudio ou vídeo em tempo real não conseguem estabelecer um caminho de mídia separado. O BigBlueButton documenta falhas de ICE juntamente com bloqueios de UDP e NAT como possíveis causas. Ação: faça um teste com a webcam e compare os resultados em diferentes redes.

“Todos os servidores devem usar as mesmas portas e configurações TURN.”

As configurações padrão documentadas são pontos de partida úteis, mas não comprovam a configuração em produção. As portas podem ser personalizadas e a configuração do TURN varia conforme a versão. Ação: inspecione a versão e a configuração implantadas antes de modificar as regras do firewall ou do relay.

Como confirmar a correção

Após uma alteração, participe de uma nova reunião e publique a webcam por pelo menos um minuto. Confirme se sua pré-visualização local aparece, se outros participantes conseguem ver a transmissão e se a reconexão não reproduz o erro ICE. Peça a um usuário na rede anteriormente afetada para repetir o mesmo teste. Se apenas o teste no hotspot for bem-sucedido, informe o resultado ao administrador da rede e solicite a revisão do tráfego WebRTC de saída. Se todas as redes falharem para vários usuários, envie ao host do BigBlueButton a versão do servidor, o horário aproximado, os navegadores afetados, o código de erro ou a mensagem exata, se o áudio funciona e os resultados de cada teste de rede. Evite publicar links de reuniões, tokens de acesso ou logs de navegador não editados publicamente.

Um diagnóstico preciso ajuda a identificar a camada com falha: acesso local à câmera, rede de um usuário ou rota de mídia do servidor. A mensagem por si só não consegue distinguir esses casos, mas essas verificações podem fornecer ao administrador evidências para a próxima alteração.

Referências oficiais

• Guia de Solução de Problemas do BigBlueButton 4.0
• Configuração do firewall BigBlueButton
• Configuração do servidor TURN BigBlueButton 4.0
• MDN: MediaDevices.getUserMedia()