WebRTC Streaming
WebRTC bietet das latenzärmste Kamera-Streaming in HomeBe·at. Hier erfährst du, wie du es mit deiner Home Assistant Instanz einrichtest.
Warum WebRTC?
HomeBe·at unterstützt mehrere Streaming-Protokolle. WebRTC bietet die beste Balance aus niedriger Latenz und Qualität — typischerweise unter 1 Sekunde Verzögerung, verglichen mit 5–15 Sekunden bei HLS.
| Protokoll | Latenz | Qualität | Einrichtung |
|---|---|---|---|
| WebRTC | < 1s | Hoch | Integriert seit HA 2024.11 |
| RTSP | < 1s | Hoch | Direkte Verbindung zur Kamera |
| HLS | 5–15s | Mittel | In HA-Kameras integriert |
| MJPEG | 1–2s | Niedrig | Integrierter Fallback |
go2rtc in Home Assistant
go2rtc ist seit Version 2024.11 in Home Assistant integriert und bietet WebRTC-Streaming direkt einsatzbereit.
Voraussetzungen
- Home Assistant 2024.11+ mit go2rtc-Integration
- Docker-basierte Installation (HA OS, Container oder Supervised) — go2rtc ist NICHT in Python/Core-Installationen verfügbar
- UDP-Netzwerkverbindung zwischen dem HA-Server und deinem Gerät
Standardkonfiguration
Moderne Versionen von Home Assistant beinhalten go2rtc-Unterstützung out of the box. Wenn deine Kameras einen RTSP-Stream bereitstellen, kann HA go2rtc automatisch für die WebRTC-Übertragung nutzen. Prüfe, ob deine Kamera-Entities im HA-Dashboard eine "WebRTC"-Stream-Option anzeigen.
Manuelle go2rtc-Konfiguration
Für Kameras, die sich nicht automatisch konfigurieren, kannst du sie in deiner go2rtc.yaml-Konfiguration hinzufügen:
streams:
front_door:
- rtsp://admin:[email protected]:554/stream1
backyard:
- rtsp://admin:[email protected]:554/h264Streaming in HomeBe·at
HomeBe·at unterstützt WebRTC, HLS und MJPEG Streaming für Home Assistant Kameras sowie RTSP für benutzerdefinierte Kameras. Die App erkennt automatisch, welche Protokolle für jede Kamera verfügbar sind, und nutzt das beste. Du kannst das Stream-Protokoll pro Kamera in den App-Einstellungen überschreiben.
Unterstützte Codecs
HomeBe·at unterstützt H.264, H.265 (HEVC), VP8, VP9 und AV1. Der Codec wird automatisch zwischen go2rtc und der App während des WebRTC-Handshakes ausgehandelt. Keine manuelle Konfiguration erforderlich — wenn deine Kamera in H.265 streamt, wird es nativ dekodiert.
Reolink-Kameras
Reolink-Kameras, die separate Fluent- (niedrige Auflösung) und Clear- (hohe Auflösung) Stream-Entities bereitstellen, funktionieren nativ mit HomeBe·at. Die App erkennt diese Auflösungskanäle und nutzt sie für die Qualitätsumschaltung — Mittlere Qualität verbindet sich mit dem Fluent-Stream, Hohe Qualität mit dem Clear-Stream. Dies vermeidet Bitraten-Drosselung und bietet bei jeder Qualitätsstufe die beste Bildqualität. Multi-Linsen-Kameras (z. B. Reolink Duo 3 PoE) erscheinen als separate Kameras, eine pro Linse.
Clear-Kanal-Entities aktivieren
Standardmäßig aktiviert Home Assistant nur die Fluent-Entity (niedrige Auflösung) für Reolink-Kameras. Um hochqualitatives Streaming in HomeBe·at zu erhalten, musst du den Clear-Kanal aktivieren:
- Gehe in Home Assistant zu Einstellungen → Geräte & Dienste → Reolink
- Klicke auf dein Kameragerät
- Unter Entities findest du die deaktivierten Entities (ausgegraut oder hinter einem „Deaktivierte anzeigen“-Schalter)
- Aktiviere die Clear-Kamera-Entity (z. B. camera.einfahrt_clear oder camera.einfahrt_clear_lens_0)
- Warte einige Sekunden, bis HA die Entity registriert, dann starte HomeBe·at neu oder verbinde dich erneut
Nach der Aktivierung erkennt HomeBe·at automatisch den Clear-Kanal und nutzt ihn für hochqualitatives Streaming.
Zusätzliche Reolink-Entities
Reolink-Kameras stellen mehrere weitere Entities bereit, die HomeBe·at nutzen kann, wenn sie in Home Assistant aktiviert sind:
| Entity | Typ | Beschreibung |
|---|---|---|
| Fluent/Clear Bitrate | Zahl (Schieberegler) | Stream-Bitrate für jeden Kanal. Anpassen, um die Bandbreitennutzung zu steuern. |
| Fluent/Clear Bildrate | Zahl (Schieberegler) | Stream-Bildrate für jeden Kanal. Höhere FPS = flüssigeres Video. |
| PTZ-Positionssensoren | Sensor | Aktuelle Schwenk- und Neigungsposition (nur lesbar). |
| PTZ-Tasten | Taste | Richtungsbewegung (links, rechts, oben, unten) und Stopp. HomeBe·at nutzt Gedrückthalten für kontinuierliche Bewegung. |
| PTZ-Zoom | Zahl (Schieberegler) | Optischer Zoomwert. HomeBe·at teilt den Bereich in nutzbare Stufen für die +/- Zoomsteuerung auf. |
| PTZ-Voreinstellungen | Auswahl/Taste | Gespeicherte Kamerapositionen (z. B. „Haustür“, „Einfahrt“). |
Um diese Entities zu aktivieren, folge den gleichen Schritten wie für den Clear-Kanal — finde sie unter den deaktivierten Entities des Geräts in Home Assistant und schalte sie ein.
Fehlerbehebung
WebRTC verbindet sich nicht
- Prüfe, ob go2rtc läuft — Gehe in Home Assistant zu Einstellungen > Add-ons und überprüfe, ob go2rtc aktiv ist.
- Prüfe die UDP-Konnektivität — WebRTC erfordert UDP-Verkehr zwischen dem HA-Server und deinem Gerät. Manche Firmen- oder restriktive Netzwerke blockieren UDP.
- Prüfe die Fehlercodes — Wenn HA "unknown_command" zurückgibt, existiert der WebRTC-Endpunkt nicht (aktualisiere auf HA 2024.11+). Wenn "not_found" zurückgegeben wird, ist die go2rtc-Integration nicht geladen.
Automatischer Fallback
Wenn WebRTC fehlschlägt, fällt HomeBe·at sofort auf MJPEG zurück und versucht gleichzeitig, einen HLS-Stream aufzubauen. Sobald HLS bereit ist, übernimmt es von MJPEG. Du siehst, wie sich das aktive Protokoll-Badge an der Kamera während des Fallbacks aktualisiert.
Nutzer, die WebRTC nicht verwenden können
- Python/Core Home Assistant Installationen (kein go2rtc)
- Nutzer, die go2rtc manuell deaktiviert haben
- Netzwerke, die jeglichen UDP-Verkehr blockieren
In diesen Fällen fällt HomeBe·at automatisch auf MJPEG oder HLS zurück.