BigBlueButton-Webcam lädt nicht: Fehler bei der ICE-Socket-Verbindung

Wenn die Webcam von BigBlueButton ein schwarzes Bild liefert und der Browser oder die Besprechung die Meldung „ICE Socket Connection Failed“ anzeigt, deutet dies zwar auf eine fehlerhafte Medienverbindung hin, nennt aber keine eindeutige Ursache. Die Kameraberechtigungen, das Netzwerk des Benutzers, die Server-Firewall, die NAT-Adressierung und die TURN-Relay-Einstellungen können alle eine Rolle spielen. Führen Sie daher zunächst Überprüfungen durch, die das Problem eingrenzen, bevor Sie die Serverkonfiguration ändern.

Die aktuelle Fehlerbehebungsanleitung von BigBlueButton beschreibt einen ähnlichen Fehler, 1007: ICE-Aushandlung fehlgeschlagen , als ein Problem beim Aushandeln eines Pfades zwischen Browser und Medienserver. Als mögliche Ursachen werden NAT, blockierte UDP-Ports und die gegebenenfalls erforderliche Aktivierung von TURN in restriktiven Netzwerken genannt. Die genaue Fehlermeldung in Ihrem Browser kann je nach BigBlueButton-Version, Hosting-Plattform oder Client variieren. Betrachten Sie sie als Hinweis, nicht als Diagnose. Lesen Sie die Fehlerbehebungsanleitung für BigBlueButton 4.0 .

Zuerst muss festgestellt werden, ob die Kamera oder die Verbindung defekt ist.

Der Browser benötigt die Kameraberechtigung, um auf eine Webcam zuzugreifen, und die Meeting-Seite muss eine sichere Verbindung wie HTTPS verwenden. Diese Prüfungen bestimmen, ob der Browser lokales Video aufzeichnen kann. ICE ist der WebRTC-Prozess, der eine Netzwerkroute für die Medienübertragung zwischen Browser und BigBlueButton findet. Eine verweigerte Kameraberechtigung und ein fehlgeschlagener ICE-Routenaufbau sind unterschiedliche Probleme, können aber in beiden Fällen dazu führen, dass die Webcam nicht verfügbar ist. MDN dokumentiert die Anforderungen an Browserberechtigungen und sichere Verbindungen .

Überprüfen Sie das Kamerasymbol neben der Adressleiste und die Website-Einstellungen Ihres Browsers. Erlauben Sie der BigBlueButton-Website den Kamerazugriff, stellen Sie sicher, dass die gewünschte Kamera ausgewählt ist, und schließen Sie alle anderen Apps, die möglicherweise darauf zugreifen. Wenn der Browser eine lokale Vorschau anzeigt, die Videoübertragung im Meeting aber weiterhin nicht funktioniert, ist der lokale Gerätezugriff wahrscheinlich aktiviert; fahren Sie mit den Netzwerkprüfungen fort. Wird keine Vorschau angezeigt, überprüfen Sie zunächst die Geräteauswahl, die Datenschutzeinstellungen Ihres Betriebssystems oder die Browserberechtigungen.

Führen Sie diese Teilnehmerprüfungen der Reihe nach durch.

1. Laden Sie die Seite einmal neu und treten Sie der Besprechung erneut bei. Verlassen Sie die Besprechung, laden Sie die Seite neu, treten Sie erneut bei und versuchen Sie es erneut mit der Webcam. Dadurch kann ein vorübergehendes Browser- oder Mediensitzungsproblem behoben werden. Ein wiederholter ICE-Fehler erfordert jedoch in der Regel eine Netzwerk- oder serverseitige Fehlerbehebung.
2. Aktualisieren Sie Ihren Browser oder wechseln Sie zu einem unterstützten Browser. Testen Sie eine aktuelle Version eines anderen unterstützten Desktop-Browsers. Falls die Webcam dort funktioniert, notieren Sie den ursprünglichen Browser und dessen Version für den Meeting-Host. Browserspezifisches Verhalten kann auftreten; ein funktionierender Browser beweist daher nicht, dass der Server für alle Benutzer korrekt konfiguriert ist.
3. Vergleichen Sie ein anderes Netzwerk. Falls möglich, verbinden Sie sich über einen mobilen Hotspot oder ein anderes vertrauenswürdiges Netzwerk. Eine funktionierende Webcam-Verbindung über die zweite Verbindung deutet stark darauf hin, dass das ursprüngliche WLAN, VPN, der Proxy oder die Unternehmensfirewall den Mediendatenverkehr einschränkt. Es beweist jedoch nicht, welche spezifische Regel dafür verantwortlich ist.
4. Testen Sie denselben Raum mit einem anderen Teilnehmer. Können mehrere Personen in unterschiedlichen Netzwerken ihre Webcams nicht freigeben, melden Sie dem Meeting-Administrator ein wahrscheinliches Server- oder Hosting-Problem. Falls nur eine Person betroffen ist, überprüfen Sie zunächst deren Gerät, Browser und Netzwerk.
5. Testen Sie einen anderen BigBlueButton-Raum oder eine Demo. Falls Ihre Organisation dies zulässt, nutzen Sie einen separaten Raum oder den offiziellen BigBlueButton-Testdienst. Funktioniert die Kamera dort, aber nicht auf dem Server Ihrer Organisation, teilen Sie dies dem Administrator mit.

Was Administratoren überprüfen sollten

Wenn mehrere Benutzer betroffen sind, überprüfen Sie den Medienpfad an jeder Netzwerkgrenze: Host-Firewall, Cloud-Sicherheitsgruppe, Router oder NAT-Gerät sowie alle vorgelagerten Netzwerk-Firewalls. Die Firewall-Dokumentation von BigBlueButton listet TCP 80 und 443 für Webverkehr und in der dokumentierten Standardkonfiguration UDP 16384–32768 für Mediendaten auf. Ihre Installation verwendet möglicherweise einen benutzerdefinierten Bereich oder einen versionsspezifischen Medien-Stack. Überprüfen Sie daher die tatsächliche Konfiguration, bevor Sie Regeln ändern. Öffnen Sie keinen größeren Bereich als von der Installation benötigt. Lesen Sie die aktuelle BigBlueButton-Firewall-Konfigurationsanleitung .

Bei einem Server hinter NAT stellen Sie sicher, dass der Mediendienst eine erreichbare externe IP-Adresse angibt. BigBlueButton 2.5 und höher verwenden mediasoup für HTML5-WebRTC-Medien. Die offizielle Firewall-Anleitung beschreibt die Konfiguration der angekündigten externen Adresse /etc/bigbluebutton/bbb-webrtc-sfu/production.yml. Eine private Adresse, eine veraltete öffentliche Adresse, eine fehlerhafte Portweiterleitung oder eine fehlende IPv6-Konfiguration können verhindern, dass Clients den Mediendienst erreichen. Befolgen Sie nur die Anweisungen, die zu Ihrer BigBlueButton-Version und Ihrem Netzwerkaufbau passen, und starten Sie die Dienste nur wie in der Anleitung beschrieben neu.

Prüfen Sie außerdem, ob betroffene Benutzer in Netzwerken arbeiten, die ausgehende UDP-Verbindungen blockieren. Ein TURN-Server kann WebRTC-Datenverkehr weiterleiten, wenn keine direkte Route verfügbar ist. Er muss jedoch installiert, erreichbar und für die entsprechende BigBlueButton-Version konfiguriert sein. Die TURN-Dokumentation und die Standardeinstellungen des Pakets unterscheiden sich je nach Version. Befolgen Sie die Anleitung für Ihre spezifische Version. Kopieren Sie keine Anmeldeinformationen oder Porteinstellungen aus einer anderen Version. Lesen Sie die Anleitung für den BigBlueButton 4.0 TURN-Server .

Häufige Annahmen, die es zu vermeiden gilt

„Die Webcam-Fehlermeldung bedeutet, dass die Kamera defekt ist.“

Nicht unbedingt. Wenn die lokale Vorschau angezeigt wird und der Browser die Berechtigung hat, kann das Gerät funktionieren, während die Medienübertragung ausfällt. Maßnahme: Versuchen Sie es mit einem anderen Netzwerk und fragen Sie nach, ob andere Teilnehmer betroffen sind, bevor Sie die Kamera austauschen.

„Das Zulassen der Kamera behebt jeden Webcam-Fehler.“

Die Berechtigung ermöglicht dem Browser lediglich die Videoaufnahme. Sie öffnet weder blockierten UDP-Verkehr noch korrigiert sie die NAT-Adresse eines Servers. Empfehlung: Testen Sie die Verbindung nach Bestätigung der Berechtigung von einem anderen Netzwerk aus.

„Eine Besprechung, die normal lädt, beweist, dass ihr Mediennetzwerk funktioniert.“

Die Seite und die Steuerungselemente für Besprechungen können über HTTPS geladen werden, während Echtzeit-Audio und -Video keinen separaten Medienpfad herstellen können. BigBlueButton dokumentiert ICE-Fehler neben blockiertem UDP und NAT als mögliche Ursachen. Empfehlung: Führen Sie einen Webcam-Test durch und vergleichen Sie die Ergebnisse in verschiedenen Netzwerken.

„Jeder Server sollte die gleichen Ports und TURN-Einstellungen verwenden.“

Dokumentierte Standardeinstellungen sind nützliche Ausgangspunkte, aber kein Beweis für die tatsächliche Konfiguration. Ports können angepasst werden, und die TURN-Konfiguration variiert je nach Version. Empfehlung: Überprüfen Sie Ihre eingesetzte Version und Konfiguration, bevor Sie Firewall- oder Relay-Regeln ändern.

So bestätigen Sie die Reparatur

Nach einer Änderung treten Sie einem neuen Meeting bei und aktivieren Sie die Webcam für mindestens eine Minute. Prüfen Sie, ob Ihre lokale Vorschau angezeigt wird, andere Teilnehmer den Stream sehen können und der ICE-Fehler nach einer erneuten Verbindung nicht auftritt. Bitten Sie einen Benutzer im zuvor betroffenen Netzwerk, den Test zu wiederholen. Wenn nur der Hotspot-Test erfolgreich ist, teilen Sie dies dem Netzwerkadministrator mit und bitten Sie um eine Überprüfung des ausgehenden WebRTC-Verkehrs. Falls alle Netzwerke für mehrere Benutzer fehlschlagen, senden Sie dem BigBlueButton-Host die Serverversion, die ungefähre Uhrzeit, die betroffenen Browser, den Fehlercode bzw. die genaue Fehlermeldung, ob die Audioübertragung funktioniert, und die Ergebnisse jedes Netzwerktests. Vermeiden Sie es, Meeting-Links, Zugriffstoken oder ungeschwärzte Browserprotokolle öffentlich zu posten.

Eine hilfreiche Diagnose grenzt die fehlerhafte Ebene ein: lokaler Kamerazugriff, das Netzwerk eines Benutzers oder die Medienroute des Servers. Die Fehlermeldung allein kann diese Fälle nicht unterscheiden, aber diese Prüfungen liefern Ihrem Administrator Anhaltspunkte für die nächste Änderung.

Offizielle Referenzen

• BigBlueButton 4.0 – Leitfaden zur Fehlerbehebung
• BigBlueButton Firewall-Konfiguration
• BigBlueButton 4.0 TURN-Serverkonfiguration
• MDN: MediaDevices.getUserMedia()