Fehlercode 1003 erscheint in BigBlueButton, bevor überhaupt eine Verbindung zum Server aufgebaut wird. Er bedeutet, dass der verwendete Browser entweder nicht unterstützt wird oder zu alt ist, um die für BBB erforderlichen WebRTC-Funktionen bereitzustellen. Da die Prüfung direkt beim Laden der Anwendung stattfindet, sehen Betroffene diesen Fehler in der Regel sofort nach dem Beitreten – noch bevor sie Audio oder Video aktivieren können.

Wie äußert sich der Fehler?

BigBlueButton zeigt eine Fehlermeldung mit dem Code 1003 an und verhindert das weitere Laden der Sitzung. Je nach Konfiguration kann die Meldung als Vollbild-Fehlerseite oder als modaler Dialog erscheinen. Zusätzlich kann – noch vor dem eigentlichen Fehlercode – ein Hinweisbanner erscheinen, der auf einen nicht unterstützten oder veralteten Browser aufmerksam macht (z. B. „Es sieht so aus, als würden Sie einen nicht unterstützten Browser verwenden.”).

Mögliche Ursachen

• Veralteter Browser: Der Browser unterschreitet die Mindestversion, die BBB voraussetzt (Chrome 87+, Firefox 80+, Edge 85+, Safari 14+).
• Nicht unterstützter Browser: Internet Explorer unterstützt WebRTC grundsätzlich nicht. Auch exotische oder stark eingeschränkte Browser können betroffen sein.
• Kein HTTPS: Chrome und Firefox erlauben den Zugriff auf Mikrofon und Kamera (getUserMedia) nur über sichere HTTPS-Verbindungen. Wird BBB über einfaches HTTP betrieben, schlägt diese API-Anfrage fehl und BBB meldet Fehler 1003.
• Chrome für iOS (CriOS): Chrome auf iPhone oder iPad verwendet Apples WKWebView statt der Chromium-Engine – mit eingeschränkter WebRTC-Unterstützung. BBB empfiehlt auf iOS ausdrücklich Safari.
• BBB in einem iframe eingebettet: Fehlt dem iframe-Element das Attribut allow="microphone; camera", verweigert der Browser den Zugriff auf Mediengeräte.
• Sicherheitssoftware oder Gruppenrichtlinien: Antivirenprogramme (z. B. Kaspersky, Symantec) oder Windows-Gruppenrichtlinien können WebRTC-API-Aufrufe blockieren.

Lösungen

Für Teilnehmer

1. Browser aktualisieren: Öffnen Sie die Update-Seite Ihres Browsers: Chrome: chrome://settings/help | Firefox: about:support → Auf Updates prüfen | Edge: edge://settings/help | Safari: macOS-Systemeinstellungen → Softwareupdate.
2. Zu einem unterstützten Browser wechseln: Falls Sie Internet Explorer oder einen unbekannten Browser verwenden, installieren Sie eine aktuelle Version von Chrome, Firefox, Edge oder Safari.
3. Auf iOS Safari verwenden: Wenn Sie ein iPhone oder iPad nutzen, öffnen Sie den BBB-Link in Safari statt in Chrome oder einem anderen Browser.
4. WebRTC-Kompatibilität testen: Besuchen Sie https://test.webrtc.org/, um zu prüfen, ob Ihr Browser WebRTC grundsätzlich unterstützt.
5. Im Inkognito-Modus testen: Öffnen Sie BBB in einem privaten Fenster. Ist der Fehler dort nicht vorhanden, blockiert möglicherweise eine Browsererweiterung oder Antivirensoftware den Zugriff.

Für Administratoren

1. HTTPS sicherstellen: Prüfen Sie, ob BBB über HTTPS erreichbar ist: sudo bbb-conf --check zeigt SSL-Warnungen an. Ohne gültiges Zertifikat verweigern moderne Browser den Medienzugriff.
2. iframe-Einbettung korrigieren: Wenn BBB in einer Lernplattform per iframe eingebettet ist, muss das iframe-Element folgende Berechtigungen enthalten: allow="microphone; camera; display-capture; autoplay".
3. Firmen-Browser in die Unterstützungsliste aufnehmen: Bei Browsern mit angepasstem User-Agent (z. B. vom Arbeitgeber verwaltete Chromium-Versionen) kann die Datei /usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml angepasst werden. Nach der Änderung BBB neu starten: sudo bbb-conf --restart. Damit die Änderung BBB-Updates überlebt, tragen Sie sie in /etc/bigbluebutton/bbb-conf/apply-config.sh ein.
4. Browser-Konsole auswerten: Bitten Sie Betroffene, beim Beitretversuch die Entwicklertools (F12 → Konsole) zu öffnen. Einträge wie TypeError: navigator.mediaDevices is undefined deuten auf ein HTTP-Problem hin; NotAllowedError auf blockierte Berechtigungen.

Weitere Informationen

Fehler 1003 tritt ausschließlich beim Start auf und ist klar von Verbindungsproblemen während einer laufenden Sitzung zu unterscheiden. Ähnliche Fehlercodes: 1001 (WebSocket getrennt) und 1002 (WebSocket-Verbindung fehlgeschlagen) betreffen dagegen den Netzwerk-Verbindungsaufbau zum BBB-Server und sind nicht browserspezifisch.