Webcam-Probleme in BigBlueButton – Fehlermeldungen & Lösungen

Wenn Sie in BigBlueButton Ihre Webcam nutzen möchten, können verschiedene Fehlermeldungen auftreten. Dieser Artikel erklärt alle bekannten Webcam-Fehlermeldungen, ihre Ursachen und die passenden Lösungen – von Berechtigungsproblemen über Gerätefehler bis hin zu Verbindungsproblemen und virtuellen Hintergründen.

Berechtigungsfehler

Die häufigsten Webcam-Probleme entstehen durch fehlende Kameraberechtigungen im Browser oder Betriebssystem.

Kameraberechtigung verweigert

Error on sharing webcam. Please check permissions
Permission to access webcams needs to be granted

Wann tritt das auf?

Diese Meldungen erscheinen, wenn Ihr Browser keine Berechtigung hat, auf die Kamera zuzugreifen. Entweder haben Sie die Berechtigung aktiv abgelehnt, oder Ihr Browser bzw. Betriebssystem blockiert den Zugriff generell.

Mögliche Ursachen

  • Sie haben im Browser-Popup auf „Blockieren” geklickt
  • In den Website-Einstellungen des Browsers ist die Kamera für diese Seite gesperrt
  • Auf macOS: Die Systemberechtigungen erlauben dem Browser keinen Kamerazugriff
  • Die Seite wird über HTTP statt HTTPS aufgerufen (unsichere Verbindung)

Lösungen

  1. Chrome: Klicken Sie auf das Schloss- oder Kamerasymbol in der Adressleiste → Website-Einstellungen → Kamera → Zulassen
  2. Firefox: Klicken Sie auf das Schloss-Symbol → Berechtigungen → Kamera verwenden → Erlauben
  3. macOS: Systemeinstellungen → Datenschutz & Sicherheit → Kamera → Häkchen beim Browser setzen
  4. Laden Sie die Seite anschließend neu

Kamera durch Browser-Richtlinie gesperrt

Your browser has disabled camera usage. Try a different browser

Wann tritt das auf?

Der Browser selbst blockiert den Kamerazugriff auf Richtlinienebene – das geht über die normalen Berechtigungseinstellungen hinaus.

Mögliche Ursachen

  • Der Browser wird durch eine Unternehmensrichtlinie (z. B. GPO/MDM) eingeschränkt
  • Serverseitige HTTP-Header (Permissions-Policy oder Feature-Policy) blockieren die Kamera
  • Der Browser läuft in einem eingeschränkten Modus (z. B. Kiosk-Modus)

Lösungen

  1. Verwenden Sie einen anderen Browser (Chrome, Firefox oder Edge)
  2. Sprechen Sie Ihren IT-Administrator an, falls Unternehmensrichtlinien gelten

Gerätefehler

Diese Fehlermeldungen betreffen Probleme mit der Webcam-Hardware selbst oder deren Verfügbarkeit.

Keine Webcam gefunden

No webcams found. Please make sure there’s one connected

Wann tritt das auf?

Der Browser kann kein Kameragerät erkennen – entweder ist keine Webcam angeschlossen oder das Gerät wird vom System nicht erkannt.

Mögliche Ursachen

  • Keine Webcam am Computer angeschlossen
  • Kameratreiber nicht installiert oder fehlerhaft
  • Die Webcam wird von einer anderen Anwendung exklusiv belegt

Lösungen

  1. Schließen Sie eine Webcam an und laden Sie die Seite neu
  2. Prüfen Sie im Geräte-Manager (Windows) oder in den Systeminformationen (macOS), ob die Kamera erkannt wird
  3. Schließen Sie andere Programme, die die Kamera nutzen könnten

Kamera wird von anderer Anwendung blockiert

Could not get webcam video. Please make sure another program is not using the webcam

Wann tritt das auf?

Die Kamera ist zwar vorhanden, konnte aber nicht gestartet werden, da ein anderes Programm sie bereits verwendet.

Mögliche Ursachen

  • Programme wie Zoom, Teams, Skype oder OBS haben die Kamera geöffnet
  • Ein USB-Lesefehler der Webcam
  • Ein Windows-DirectShow- oder macOS-Systemfehler

Lösungen

  1. Schließen Sie alle anderen Programme, die die Kamera nutzen könnten
  2. Trennen Sie die USB-Webcam und schließen Sie sie erneut an
  3. Starten Sie den Browser neu

Kamerazugriff unerwartet abgebrochen

An unknown problem occurred which prevented your camera from being used

Wann tritt das auf?

Der Kamerazugriff wurde vom Browser oder Betriebssystem aus unbekannten Gründen abgebrochen – es handelt sich weder um ein Berechtigungs- noch um ein Hardwareproblem.

Lösungen

  1. Schließen Sie andere Anwendungen, die die Kamera nutzen
  2. Falls Sie eine USB-Webcam verwenden: Trennen und erneut anschließen
  3. Laden Sie die Seite neu

Qualitätsprofil wird nicht unterstützt

Your camera does not support this quality profile

Wann tritt das auf?

Das gewählte Qualitätsprofil (z. B. HD) verlangt eine Auflösung oder Bildrate, die Ihre Webcam nicht unterstützt. Beispiel: HD (1920×1080) wird angefordert, Ihre Kamera kann aber nur 720p.

Lösungen

  1. Wählen Sie in den Webcam-Einstellungen ein niedrigeres Qualitätsprofil (z. B. von „Hoch” auf „Mittel” oder „Niedrig”)

Verbindungsfehler

Diese Fehlermeldungen treten auf, wenn die Netzwerkverbindung zwischen Ihrem Browser und dem BBB-Server gestört ist.

ICE-Verbindungsfehler

Connection failure (ICE error 1107)
Error on adding ICE candidate

Wann tritt das auf?

Beim Aufbau der Webcam-Verbindung konnte keine direkte Netzwerkverbindung (über das sogenannte ICE-Protokoll) zwischen Ihrem Browser und dem Server hergestellt werden. Dieses Protokoll sucht den besten Verbindungsweg – wenn keiner funktioniert, schlägt die Kameraübertragung fehl.

Mögliche Ursachen

  • Eine restriktive Firewall oder ein Unternehmensnetzwerk blockiert die benötigten Netzwerkverbindungen (UDP-Ports)
  • Der Server ist falsch konfiguriert (z. B. falsche öffentliche IP-Adresse)
  • Kein TURN-Server eingerichtet – dieser wird benötigt, wenn eine direkte Verbindung nicht möglich ist
  • Hohe Serverlast, sodass Verbindungen nicht schnell genug aufgebaut werden können

Lösungen

  1. Versuchen Sie es erneut – manchmal klappt es beim zweiten Mal
  2. Wechseln Sie in ein anderes Netzwerk (z. B. vom Firmen-WLAN zum mobilen Hotspot)
  3. Sprechen Sie Ihren IT-Administrator an – möglicherweise müssen Firewall-Regeln oder die Serverkonfiguration angepasst werden

Zeitüberschreitung beim Verbindungsaufbau

Browser did not respond in time.

Wann tritt das auf?

Der Server hat nicht rechtzeitig auf die Webcam-Anfrage geantwortet. BigBlueButton wartet eine bestimmte Zeit (ca. 15 Sekunden) auf eine Antwort – bleibt diese aus, wird die Verbindung abgebrochen.

Mögliche Ursachen

  • Sehr langsame oder instabile Internetverbindung
  • Der BBB-Server ist überlastet
  • Netzwerkverbindung zum Server ist unterbrochen

Lösungen

  1. Versuchen Sie es einfach erneut – bei langsamen Netzwerken klappt es oft beim zweiten Versuch
  2. Prüfen Sie Ihre Internetverbindung
  3. Falls das Problem dauerhaft auftritt, wenden Sie sich an Ihren Serveradministrator

Webcam-Stream unterbrochen

Your webcam stream has been interrupted. Try sharing it again
Your webcam stopped unexpectedly. Please review your browser’s permissions

Wann tritt das auf?

Ihre Webcam war aktiv, aber die Übertragung wurde unerwartet unterbrochen. Entweder hat die Netzwerkverbindung Daten nicht mehr transportiert, oder die Kamera selbst hat aufgehört, Bilddaten zu liefern.

Mögliche Ursachen

  • Kurzzeitiger Netzwerkausfall oder WLAN-Wechsel (z. B. zwischen Zugangspunkten)
  • Die Kamera wurde während der Übertragung physisch getrennt
  • Kameraberechtigung wurde während der Nutzung widerrufen
  • Der Browser hat den Tab in den Hintergrund versetzt und die Kamera deaktiviert (vor allem auf Mobilgeräten)

Lösungen

  1. Teilen Sie Ihre Webcam einfach erneut
  2. Stellen Sie sicher, dass die Kameraberechtigung erteilt bleibt
  3. Halten Sie den BigBlueButton-Tab im Vordergrund

Keine Verbindung zum Server

Webcam cannot be shared due to connection issues

Wann tritt das auf?

Sie haben versucht, Ihre Webcam zu teilen, aber die Verbindung zum BigBlueButton-Server ist momentan unterbrochen.

Lösungen

  1. Warten Sie, bis die Verbindung wiederhergestellt ist (ein Hinweis-Banner wird angezeigt)
  2. Versuchen Sie danach erneut, die Webcam zu teilen

Webcam-Beschränkungen

Diese Meldungen erscheinen, wenn administrative Einschränkungen die Webcam-Nutzung verhindern.

Webcam-Freigabe gesperrt

Webcam sharing locked

Wann tritt das auf?

Ein Moderator hat die Webcam-Freigabe für Teilnehmende gesperrt. Solange diese Sperre aktiv ist, können Sie Ihre Kamera nicht teilen.

Lösungen

  1. Bitten Sie den Moderator, die Webcam-Sperre aufzuheben
  2. Für Moderatoren: Öffnen Sie Teilnehmer → Teilnehmer sperren → Webcam deaktivieren

Maximale Kameraanzahl erreicht

You cannot share more cameras
Session reached it’s simultaneous cameras limit

Wann tritt das auf?

BigBlueButton erlaubt es, mehrere Kameras gleichzeitig zu teilen, begrenzt dies aber. Die erste Meldung bedeutet, dass Sie persönlich das Kameralimit erreicht haben. Die zweite Meldung weist darauf hin, dass das gesamte Meeting die maximale Anzahl gleichzeitiger Kamerastreams erreicht hat.

Lösungen

  1. Beenden Sie eine Ihrer aktiven Kamerafreigaben, bevor Sie eine neue starten
  2. Bitten Sie andere Teilnehmende, nicht benötigte Kameras auszuschalten (bei Meeting-Limit)

Browser- und Kompatibilitätsfehler

Browser nicht unterstützt

Browser is not supported. Try again using a different browser or device

Wann tritt das auf?

Ihr Browser unterstützt die für Webcams benötigte Technologie (WebRTC) nicht oder nur eingeschränkt.

Lösungen

  1. Verwenden Sie auf dem Desktop Chrome, Firefox oder Edge in einer aktuellen Version
  2. Auf iPhones und iPads funktioniert die Webcam nur mit Safari – andere Browser auf iOS unterstützen WebRTC nicht vollständig

Allgemeiner Webcam-Fehler

Error on sharing webcam
An unknown error has occurred with the device ({error})

Wann tritt das auf?

Ein nicht näher klassifizierter Fehler ist beim Teilen der Webcam aufgetreten. Im zweiten Fall enthält {error} den technischen Fehlernamen.

Lösungen

  1. Laden Sie die Seite neu und versuchen Sie es erneut
  2. Wählen Sie ein niedrigeres Qualitätsprofil in den Kameraeinstellungen
  3. Versuchen Sie einen anderen Browser

Virtuelle Hintergründe

BigBlueButton bietet die Möglichkeit, virtuelle Hintergründe oder Weichzeichner-Effekte für die Webcam zu verwenden. Dabei können folgende Fehler auftreten.

Kameraeffekt konnte nicht angewendet werden

Failed to apply camera effect. Try again.

Wann tritt das auf?

Das Anwenden eines virtuellen Hintergrunds (Weichzeichner, Bild oder Videoeffekt) ist fehlgeschlagen. Virtuelle Hintergründe benötigen moderne Browser-Technologien wie WebAssembly und WebGL für die Echtzeit-Bildverarbeitung.

Mögliche Ursachen

  • Ihr Browser unterstützt die benötigten Technologien (WebAssembly, WebGL) nicht
  • Ihr Gerät hat nicht genug Rechenleistung für die Echtzeit-Videoverarbeitung
  • Das für die Hintergrunderkennung benötigte KI-Modell konnte nicht geladen werden

Lösungen

  1. Probieren Sie einen anderen Effekt oder deaktivieren Sie virtuelle Hintergründe
  2. Verwenden Sie einen aktuellen Browser (Chrome oder Firefox in der neuesten Version)

Hintergrundbild zu groß oder falsches Format

Maximum file size exceeded. ({maxFileSize}MB)
File type not allowed.
Something went wrong when reading the file.

Wann tritt das auf?

Sie haben versucht, ein eigenes Hintergrundbild hochzuladen, aber die Datei erfüllt die Anforderungen nicht – sie ist zu groß, hat ein nicht unterstütztes Format, oder konnte nicht gelesen werden.

Lösungen

  1. Dateigröße: Verkleinern Sie das Bild (maximale Dateigröße ist typischerweise 5 MB). Komprimieren Sie das Bild oder reduzieren Sie die Auflösung
  2. Dateiformat: Verwenden Sie JPEG oder PNG. Andere Formate wie BMP, TIFF oder HEIC werden möglicherweise nicht akzeptiert
  3. Lesefehler: Versuchen Sie, die Datei erneut hochzuladen. Stellen Sie sicher, dass es sich um eine gültige, nicht beschädigte Bilddatei handelt

Technische Details für Administratoren

Die Webcam-Fehlermeldungen in BigBlueButton basieren größtenteils auf den Standard-Fehlertypen der Browser-API getUserMedia() (z. B. NotAllowedError, NotFoundError, NotReadableError, OverconstrainedError). Darüber hinaus gibt es BBB-spezifische Fehler für Verbindungsprobleme (ICE/WebRTC) und Administrationsbeschränkungen.

Wichtige Konfigurationsdateien:

  • Kameralimits: userCameraCap und meetingCameraCap in /etc/bigbluebutton/bigbluebutton.properties
  • Qualitätsprofile: Video-Quality-Profiles in /etc/bigbluebutton/bbb-html5.yml oder settings.yml
  • ICE/TURN: TURN-Server-Konfiguration in /etc/bigbluebutton/turn-stun-servers.xml; announcedIp in /etc/bigbluebutton/bbb-webrtc-sfu/production.yml
  • Timeout: public.kurento.gatheringTimeout in settings.yml
  • Fehlercodes: ICE error 1107 entspricht dem gleichen Verbindungsfehler wie beim Audio (Fehlercode 1107)

Bei Verdacht auf serverseitige Probleme prüfen Sie die SFU-Logs: sudo tail -100 /var/log/bigbluebutton/bbb-webrtc-sfu.log und starten Sie bei Bedarf die Dienste mit sudo bbb-conf --restart neu.