Dieser Artikel behandelt die häufigsten Audio-Fehlermeldungen in BigBlueButton. Wenn Sie einer Konferenz beitreten und Probleme mit dem Mikrofon oder der Tonübertragung auftreten, zeigt BigBlueButton verschiedene Hinweise und Fehlermeldungen an. Hier finden Sie zu jeder Meldung eine Erklärung, mögliche Ursachen und konkrete Lösungsschritte.
Audio-Fehler in BigBlueButton erscheinen an unterschiedlichen Stellen: als kurze Benachrichtigung (Toast) am oberen Bildschirmrand, im Audio-Hilfedialog oder in den Audio-Einstellungen. Die folgende Übersicht ist thematisch nach Problemtyp gegliedert.
Verbindungsfehler
Diese Meldungen erscheinen, wenn die Audio-Verbindung zwischen Ihrem Browser und dem Konferenzserver nicht hergestellt werden kann.
Audio-Verbindung fehlgeschlagen
Your audio connection failed to connect
Wann tritt das auf?
Diese Meldung wird als kurze Benachrichtigung angezeigt, wenn die WebRTC-Audioverbindung zum Konferenzserver (FreeSWITCH) nicht aufgebaut werden konnte. Es handelt sich um einen allgemeinen Verbindungsfehler.
Mögliche Ursachen
- Der Audio-Dienst (FreeSWITCH) auf dem Server ist nicht erreichbar oder nicht gestartet
- Die Netzwerkverbindung zwischen Ihrem Browser und dem Server ist gestört (z. B. durch Firewall oder VPN)
- Der Browser unterstützt WebRTC nicht oder es fehlt eine HTTPS-Verbindung
- Die ICE-Aushandlung (Verbindungsaufbau zwischen Browser und Server) ist fehlgeschlagen, weil kein STUN/TURN-Server verfügbar ist
Lösungen
- Teilnehmer: Klicken Sie erneut auf “Audio beitreten”. Falls das Mikrofon nicht funktioniert, versuchen Sie den Nur-Zuhören-Modus.
- Teilnehmer: Prüfen Sie, ob die Adresse mit https:// beginnt und Ihre Internetverbindung stabil ist.
- Administrator: Führen Sie
sudo bbb-conf --checkaus, um die FreeSWITCH- und Audio-Konfiguration zu überprüfen.
Verbindungsfehler (Connection Error)
Error: Connection error
Wann tritt das auf?
Es ist ein Netzwerkfehler auf Transportebene aufgetreten. Die WebSocket- oder ICE-Verbindung zum Audio-Dienst konnte nicht hergestellt werden.
Mögliche Ursachen
- Unterbrechung der Netzwerkverbindung während des Audio-Aufbaus
- Der WebSocket-Endpunkt von FreeSWITCH ist nicht erreichbar
- Fehlkonfiguration des nginx-SIP-Proxys auf dem Server
Lösungen
- Teilnehmer: Versuchen Sie erneut, dem Audio beizutreten. Wechseln Sie gegebenenfalls das Netzwerk (z. B. vom WLAN zu mobilen Daten).
- Administrator: Prüfen Sie den FreeSWITCH-Status mit
sudo bbb-conf --checkund überprüfen Sie die nginx-Konfiguration.
Zeitüberschreitung (Timeout)
Error: There was a timeout in the request
Wann tritt das auf?
Eine Anfrage im Audio-Verbindungsprozess hat zu lange gedauert und wurde abgebrochen. Dies kann die SIP-Einladung an FreeSWITCH betreffen oder den ICE-Verbindungsaufbau (die Aushandlung des Netzwerkpfads zwischen Browser und Server).
Lösungen
- Teilnehmer: Versuchen Sie es erneut. Falls das Problem bestehen bleibt, wechseln Sie in den Nur-Zuhören-Modus oder probieren Sie ein anderes Netzwerk.
- Administrator: Überprüfen Sie die STUN/TURN-Konfiguration. Prüfen Sie, ob FreeSWITCH ordnungsgemäß auf SIP-Anfragen reagiert:
sudo systemctl status freeswitch
Ungültiges Ziel (Invalid Target)
Error: Tried to request something to an invalid target
Wann tritt das auf?
Der Client hat versucht, eine Audio-Verbindung aufzubauen, aber die interne Zieladresse (Voice-Bridge-Nummer) war leer oder ungültig. Der Anruf wurde gar nicht erst gesendet.
Mögliche Ursachen
- Die Meeting-Daten wurden nicht vollständig geladen (z. B. bei einem sehr schnellen Beitritt)
- Schnelle Wiederverbindung, bevor die Voice-Bridge-Informationen erneut verfügbar waren
Lösungen
- Verlassen Sie die Audio-Sitzung und treten Sie erneut bei.
- Falls das Problem anhält, laden Sie die Seite neu und treten Sie dem Meeting erneut bei.
Allgemeiner Fehler (Generic Error)
Error: An error has occurred, please try again
Ein nicht näher klassifizierter Fehler ist im Audio-System aufgetreten. Schließen Sie den Audio-Dialog und versuchen Sie erneut, dem Audio beizutreten. Falls der Fehler wiederholt auftritt, laden Sie die Seite neu.
Gerätefehler
Diese Meldungen erscheinen, wenn Ihr Mikrofon nicht erkannt, nicht ausgewählt oder nicht angesprochen werden kann.
Kein Mikrofon ausgewählt
No microphone selected. You’ll be able to listen, but not speak.
Wann tritt das auf?
Sie haben die Audio-Einstellungen geöffnet, aber kein Mikrofon ausgewählt – oder es ist kein Mikrofon am Gerät angeschlossen. Sie können trotzdem als Zuhörer teilnehmen, aber nicht sprechen.
Lösungen
- Schließen Sie ein Mikrofon oder Headset an und wählen Sie es in den Audio-Einstellungen aus.
- Falls Sie gerade erst ein Gerät angeschlossen haben, laden Sie die Seite neu, damit der Browser es erkennt.
- Wenn Sie kein Mikrofon benötigen, können Sie im Nur-Zuhören-Modus fortfahren.
Gerätewechsel fehlgeschlagen
Audio device change failed. Check if the chosen device is properly set up and available
Wann tritt das auf?
Sie haben in den Audio-Einstellungen ein anderes Mikrofon oder einen anderen Lautsprecher ausgewählt, aber der Browser konnte das neue Gerät nicht aktivieren.
Mögliche Ursachen
- Das gewählte Gerät wird bereits von einer anderen Anwendung (z. B. Zoom, Teams) verwendet
- Das Gerät wurde zwischen der Auswahl und der Aktivierung getrennt
- Die Browser-Berechtigung für das Gerät hat sich geändert
Lösungen
- Stellen Sie sicher, dass das Gerät korrekt angeschlossen ist und nicht von einer anderen App belegt wird.
- Schließen Sie andere Programme, die das Mikrofon nutzen könnten, und versuchen Sie es erneut.
Mediengerät-Fehler
Error: There was an issue getting your media devices
Wann tritt das auf?
Der Zugriff auf das Mikrofon ist fehlgeschlagen, bevor die Audio-Verbindung überhaupt aufgebaut wurde. Dieser Fehler deckt Fälle ab, in denen das Gerät zwar vorhanden ist, aber auf Hardware- oder Betriebssystemebene nicht gelesen werden kann.
Lösungen
- Trennen Sie das Mikrofon und schließen Sie es erneut an.
- Probieren Sie ein anderes Mikrofon oder Headset.
- Starten Sie den Browser neu und versuchen Sie es erneut.
Berechtigungsfehler
Diese Meldungen erscheinen im Audio-Hilfedialog, wenn der Browser oder das Betriebssystem den Zugriff auf Ihr Mikrofon blockiert.
Mikrofonberechtigung verweigert
We need access to your microphone
Wann tritt das auf?
Der Browser meldet, dass die Mikrofonberechtigung verweigert wurde. Entweder haben Sie im Berechtigungsdialog auf “Blockieren” geklickt, oder das Mikrofon ist in den Browser-Einstellungen für diese Seite gesperrt.
Lösungen
- Chrome / Edge: Klicken Sie auf das Schloss-Symbol in der Adressleiste → Website-Einstellungen → Mikrofon → “Zulassen”
- Firefox: Klicken Sie auf das Schloss-Symbol → Berechtigungen → Mikrofon verwenden → “Erlauben”
- Laden Sie anschließend die Seite neu.
Mikrofon nicht gefunden
We couldn’t find your microphone
Wann tritt das auf?
Der Browser konnte kein Mikrofon erkennen. Es ist kein Audio-Eingabegerät verfügbar.
Mögliche Ursachen
- Kein Mikrofon angeschlossen
- Das Mikrofon wird vom Betriebssystem nicht erkannt
- Das eingebaute Mikrofon ist in den Systemeinstellungen deaktiviert
Lösungen
- Schließen Sie ein Mikrofon oder Headset an.
- Prüfen Sie in den Betriebssystem-Einstellungen unter “Ton” bzw. “Eingabegeräte”, ob ein Mikrofon erkannt wird.
- Versuchen Sie es mit einem anderen Browser.
macOS-Systemberechtigung blockiert Mikrofon
It looks like your Mac System Preferences are blocking access to your microphone. Open System Preferences > Security & Privacy > Privacy > Microphone, and verify that the browser you’re using is checked.
Wann tritt das auf?
Auf einem Mac hat das Betriebssystem selbst den Mikrofonzugriff für den Browser blockiert. Dies ist unabhängig von der Browser-Berechtigung – selbst wenn der Browser das Mikrofon erlaubt hat, kann macOS den Zugriff auf Systemebene verweigern. Diese Einschränkung gibt es seit macOS Mojave (10.14).
Lösungen
- Öffnen Sie Systemeinstellungen (ab macOS Ventura: “Systemeinstellungen”, davor: “Systemeinstellungen” → “Sicherheit”)
- Navigieren Sie zu Datenschutz & Sicherheit → Mikrofon
- Setzen Sie den Haken neben Ihrem Browser (Chrome, Firefox, Safari etc.)
- Starten Sie den Browser neu und treten Sie dem Meeting erneut bei.
Sicherheitsfehler (HTTPS)
Kein HTTPS – Mikrofonzugriff blockiert
getUserMicMedia failed as only secure origins are allowed
This page is unsecured. For microphone access to be allowed the page must be served over HTTPS. Please contact the server administrator.
Wann tritt das auf?
Die BigBlueButton-Seite wird über eine ungesicherte HTTP-Verbindung aufgerufen (statt HTTPS). Alle modernen Browser verlangen eine verschlüsselte Verbindung, bevor sie den Zugriff auf Mikrofon oder Kamera erlauben. Ohne HTTPS ist kein Audio-Beitritt mit Mikrofon möglich.
Lösungen
- Teilnehmer: Stellen Sie sicher, dass die URL mit https:// beginnt. Informieren Sie ggf. den Administrator.
- Administrator: Richten Sie ein SSL/TLS-Zertifikat für den BBB-Server ein, z. B. mit Let’s Encrypt.
Moderator-gesteuerte Einschränkungen
Mikrofon durch Moderator gesperrt
Microphone has been locked for viewers, you are being connected as listen only
Wann tritt das auf?
Ein Moderator hat die Sperreinstellungen des Meetings geändert und die Mikrofonnutzung für Teilnehmer deaktiviert, während Sie bereits mit Mikrofon verbunden waren. Ihre Audio-Verbindung wird automatisch auf den Nur-Zuhören-Modus umgestellt.
Lösungen
Diese Einschränkung wird vom Moderator gesteuert. Wenn Sie wieder sprechen möchten, bitten Sie den Moderator, die Mikrofonsperre aufzuheben oder Ihnen eine Ausnahme zu gewähren.
Allgemeine Audio-Hilfemeldungen
BigBlueButton zeigt bei Audio-Problemen einen Hilfedialog mit einer Überschrift und einem erklärenden Untertitel. Die folgenden Meldungen erscheinen in diesem Dialog:
There was an issue with your audio devices – Allgemeine Überschrift des Audio-Hilfedialogs
We couldn’t enable your microphone – Das Mikrofon konnte nicht aktiviert werden (gerätespezifisches Problem)
We’re having trouble establishing an audio connection – Die Audio-Verbindung konnte nicht hergestellt werden (Netzwerk-/Serverproblem)
Review your browser and system settings. Restart your browser and try again. – Allgemeiner Hinweis bei unbekanntem Fehlertyp
Wenn Sie eine dieser Meldungen sehen, prüfen Sie zunächst Ihre Browser- und Systemeinstellungen. Starten Sie den Browser neu und versuchen Sie es erneut. Falls das Problem bestehen bleibt, versuchen Sie es mit einem anderen Browser oder Gerät.
Technische Details für Administratoren
Audio-Fehler in BigBlueButton erreichen die Benutzer über drei verschiedene Wege:
- SIP-Bridge → Toast-Benachrichtigung: Verbindungs- und Sitzungsfehler, die von der SIP.js-Bibliothek gemeldet werden (z. B. audioFailedMessage, mediaError, connectionError, requestTimeout, invalidTarget)
- getUserMedia → Audio-Hilfedialog: Geräte-Zugriffsfehler lösen den Hilfedialog mit spezifischen Untertiteln aus (helpSubtitlePermission, helpSubtitleNoDevice, helpSubtitleMic, help.macNotAllowed, help.noSSL)
- Sperreinstellungen → Info-Toast: Moderator-gesteuerte Sperrungen lösen eine automatische Umschaltung auf Nur-Zuhören aus (reconnectingAsListenOnly)
Wichtige Diagnosebefehle:
sudo bbb-conf --check
sudo systemctl status freeswitch
sudo journalctl -u freeswitch -n 50
tail -n 100 /opt/freeswitch/var/log/freeswitch/freeswitch.logFalls FreeSWITCH startet, aber SIP-Anfragen sofort fehlschlagen, kann eine beschädigte Datenbank die Ursache sein. In diesem Fall hilft es, die FreeSWITCH-Datenbank zurückzusetzen:
sudo systemctl stop freeswitch
sudo rm -f /opt/freeswitch/var/db/*.db
sudo systemctl start freeswitch