web: force WebTransport-only moq-watch sessions

This commit is contained in:
every.channel 2026-02-24 23:03:34 -08:00
parent 305ea39828
commit 66ce78e82d
No known key found for this signature in database
2 changed files with 30 additions and 0 deletions

View file

@ -0,0 +1,23 @@
# ECP-0076: WebTransport-Only Browser Watcher Path
## Context
The browser watcher (`@moq/watch`) races WebTransport against WebSocket fallback by default. In production relay sessions this fallback path correlates with degraded playback behavior (frequent stream resets and unreliable audio despite active subscription).
## Decision
In `apps/web/app.js`, configure each `<moq-watch>` instance to disable WebSocket fallback before connect:
- `watch.connection.websocket = { enabled: false }`
Also set default watcher volume to full (`volume="1"`) to avoid low-volume false negatives during validation.
## Rationale
- Aligns browser transport with the intended relay mode (WebTransport MoQ).
- Removes fallback-induced variability from live playback behavior.
- Keeps implementation local to web app wiring without forking upstream packages.
## Reversibility
- Remove the connection override to restore default fallback behavior.