Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion quest/m1/audio-jitter-target/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,6 @@ native playback against its budgets.
- [Calibrate](/quest/m1/audio-jitter-target/calibrate.md) - every browser and native ceiling re-measured from seven Nightlies with the model
- [Capped budgets](/quest/m1/audio-jitter-target/capped-budgets.md) - the AAC browser budgets are re-measured from nightlies after the TS importer groups each PES
- [Native A/V lag](/quest/m1/audio-jitter-target/native-av-lag.md) - `moq play --metrics` reports how far audio trails its presentation clock, so native rows grade `av_lag_ms`
- [Native rendition delay](/quest/m1/audio-jitter-target/native-rendition-delay.md) - `moq play` holds each subscribed rendition's catalog `delay` plus its target, as the browser does
- [Chromium Opus stalled share](/quest/m1/audio-jitter-target/opus-stalled-share.md) - the Chromium Opus browser rows' stalled-share ceiling is measured with the stretch, and passes
- [Native backpressure](/quest/m1/audio-jitter-target/native-backpressure.md) - native playback decodes audio only when the ring has room, holding the rest of the target encoded as the browser does

Expand Down
10 changes: 10 additions & 0 deletions quest/m1/audio-jitter-target/native-backpressure.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,16 @@ them passed in:
a gate on it would decode at a depth the sink has already outrun and could
not replace #8362's hold.

Decided 2026-11-09 (maintainer, /quest-unblock): the gate must not start
audio early when a shared catalog delay is under the ring's cap, with a test.
✅ Fix it here (rejected: pad the missing lead in
[moq-dev/moq#8362](https://github.com/moq-dev/moq/pull/8362)). With a shared delay
that fits the sink's cap, that PR writes the frame without its hold-path lead
padding, so audio can start up to ~150 ms early
(`rs/moq-cli/src/play/media.rs`). The browser-mirroring refill starts with the
whole target ahead of the playhead and replaces that padding path, so the fix
lands with the gate.

Keep the gate inside moq-audio's consumer if that stays additive; if it needs
a public API change, it moves to m2.

Expand Down
26 changes: 0 additions & 26 deletions quest/m1/audio-jitter-target/native-rendition-delay.md

This file was deleted.

8 changes: 8 additions & 0 deletions quest/m1/audio-jitter-target/stretch-setting.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ silence, and drift between the publisher's clock and the device's is
corrected by a small skip or pad. The default is 2 s whether `delay` is
`auto` or fixed, so a fixed-delay live player also keeps late audio and
catches up.
`AUTO_MAX_DELAY` is deleted in both `js/watch/src/audio/latency.ts` and
`rs/moq-cli/src/play/args.rs`: every budget it fed (the subscription max
delay, the sink cap, and video retention) is derived from `delay + stretch`.

## Plan

Expand All @@ -28,6 +31,11 @@ want stretching.
- Default: ✅ 2 s for `auto` and fixed delays alike (rejected: a fixed delay
keeping max delay equal to the delay).
- Milestone: ✅ m1 (rejected: m2). The attribute and flag are additive.
- Decided 2026-11-09 (maintainer, /quest-unblock): ✅ delete
`AUTO_MAX_DELAY` in both players and derive every budget it fed
(subscription max delay, sink cap, video retention) from `delay + stretch`
(rejected: keep the 2 s constant beside the setting). The 2 s is an
arbitrary constant nobody can trace.

The audio subscription's max delay is what makes late audio arrive at all:
the relay and the container consumer drop media older than it. Today it is 2 s
Expand Down
1 change: 0 additions & 1 deletion quest/m1/audio-jitter-target/stretch.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,5 +135,4 @@ Public API: none expected. Wire: none.
## Related

- [The `stretch` setting](/quest/m1/audio-jitter-target/stretch-setting.md) - makes this quest's skip bound configurable, and zero turns the stretch off
- [Native rendition delay](/quest/m1/audio-jitter-target/native-rendition-delay.md) - the PCM queue native backpressure replaces
- [Audio outlives video under bufferbloat](/quest/m4/audio-bufferbloat-av.md) - the audio and video congestion rows this behavior is asserted on
Loading
Loading