flan/advanced-camera-card
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: Fix audio for cameras with mixed WebRTC/HLS capabilities (#2557)

Browse Source 
- Closes #2479
This commit is contained in:
Dermot Duffy
2026-06-30 17:45:13 -07:00
committed by dermotduffy
parent 5c97e55a56
commit 937ba647a7
3 changed files with 140 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/configuration/cameras/live-provider.md
+32
View File
@@ -43,6 +43,38 @@ cameras:
> [`capabilities.force`](./README.md?id=capabilities) to skip metadata
> detection entirely.
## `ha`
The `ha` block configures use of the default Home Assistant (`ha`) live provider. It has no configuration options.
```yaml
cameras:
- camera_entity: camera.office
live_provider: ha
```
The native stream provider in Home Assistant dynamically chooses between HLS and
WebRTC streams. It prefers the lowest-latency stream (WebRTC) and only falls
back to HLS when that is the only way to get audio.
| WebRTC stream | HLS Stream | Muted? | Resulting Stream Selection |
| ------------- | ------------ | -------- | -------------------------- |
| Has audio | _Either_ | _Either_ | WebRTC (lowest latency) |
| Has no audio | Has audio | Yes | WebRTC (lowest latency) |
| Has no audio | Has audio | No | HLS (for audio) |
| Has no audio | Has no audio | _Either_ | WebRTC (lowest latency) |
> [!NOTE]
> When using the `ha` provider through Advanced Camera Card, streams are chosen
> by the same logic as the table above (the logic Home Assistant uses). The one
> difference is **when the choice is made**: the card re-runs the selection
> whenever you unmute (whether from the card's mute button or the video's own
> controls), whereas Home Assistant effectively fixes "muted" per dashboard card
> and never re-selects after that. So for a camera whose low-latency stream has
> **no audio**, unmuting in the card switches you to the audio-enabled stream,
> which may take a moment to load and run with a little more latency That
> audio-enabled stream will remain loaded thereafter.
## `image`
All configuration is under: