every-channel/every.channel
1
0
Fork 0
Code Releases Activity Actions 2

web: prefer video tag with gesture audio unlock

Browse source
This commit is contained in:
every.channel 2026-02-24 23:21:19 -08:00
parent c545b2381d
commit ad81b9791a
No known key found for this signature in database
2 changed files with 63 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

26
evolution/proposals/ECP-0078-live-video-tag-first-with-audio-unlock.md Normal file
View file

@ -0,0 +1,26 @@
# ECP-0078: Live `<video>`-First Rendering With Gesture Audio Unlock
## Context
Live browser playback currently prioritizes canvas rendering. Audio can fail on first load due to autoplay policy (`AudioContext was not allowed to start`) and we still need a robust `<video>` rendering path for native controls.
## Decision
In the web watcher mount path:
1. Render live playback with a `<video>` child in `<moq-watch>` first.
2. Start muted for autoplay compatibility, then unlock audio on first user gesture by:
- forcing backend `muted=false`, `volume=1`,
- toggling paused state to trigger resume,
- unmuting the `<video>` element.
3. If `<video>` playback stalls during startup, automatically fall back to canvas rendering.
## Rationale
- Preserves the `<video>` UX target while handling browser autoplay constraints explicitly.
- Avoids total playback failure by retaining a tested canvas fallback path.
- Keeps changes local to app wiring without forking upstream MoQ player internals.
## Reversibility
- Remove the fallback timer and unlock wiring to return to a fixed rendering mode.