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
6 changes: 3 additions & 3 deletions doc/bin/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,10 +59,10 @@ turn. The same flag on an elementary PID other than the program PCR PID, a
continuity-counter gap, and the 33-bit timestamp rollover move no clock and
declare nothing. FLV covers H.264 + AAC.

MPEG-TS export restarts its clock and table cadence after a publisher rewind,
MPEG-TS export restarts its clock and table cadence after a declared marker,
discarding the old mux buffer. The first new clock packet signals the break and
stdout pacing re-anchors. Other renditions resume at their own discontinuity
boundary, so old-timeline frames cannot advance the new clock.
stdout pacing re-anchors. Every rendition joins the new program generation;
no track is fenced across the marker.

fMP4 export writes one fragment per publisher group on each track. Audio follows
the publisher's cuts; video normally follows GOPs. Closing a group flushes it
Expand Down
2 changes: 1 addition & 1 deletion doc/bin/srt.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ moq --connect https://relay.example.com/anon --broadcast event.hang import srt -

`--latency` sets the SRT receive buffer and doubles as the skip threshold on
export. Export paces each SRT payload on the media clock, and re-anchors that
pacing when the publisher rewinds, so a restarted timeline plays out from the
pacing on a declared marker, so a restarted timeline plays out from the
live edge instead of stalling until it catches up. A `--connect` URL needs a `streamid` query or a path; a listener
bridges one `--broadcast` and ignores the stream id it is offered. The
library is [`moq-srt`](https://docs.rs/moq-srt).
13 changes: 9 additions & 4 deletions drafts/draft-lcurley-moq-hang.md
Original file line number Diff line number Diff line change
Expand Up @@ -508,13 +508,17 @@ type Container =
The `kind` field selects the framing; a consumer MUST ignore a rendition whose `kind` it does not recognize.
Every container shares the same group rules:

Each moq-lite group MUST start with a keyframe.
Each moq-lite group MUST start with a keyframe, except a group that contains only a discontinuity marker.
If the codec does not support delta frames (e.g. audio), a group MAY consist of multiple keyframes.
Otherwise, a group MUST consist of a single keyframe followed by zero or more delta frames.

An empty group declares a discontinuity between codec epochs.
A consumer MUST reset codec state before decoding the next non-empty group, including reapplying any codec startup delay or pre-skip.
This applies whether the resumed timestamps move backward or forward.
A group with no decodable frames is a walk-now discontinuity: one empty codec payload and no media.
A consumer MUST NOT submit the marker to a decoder.
Empty groups (zero objects) are permitted and mean nothing.
After a discontinuity the timeline continues forward.
A group whose timestamps fall below the live edge earlier groups reached is malformed.
A delivered sequence hole is a playhead event unless the boundary is contiguous within 1 ms.
A consumer re-applies startup delay and skip at a playhead event; it does not reset codec state.

## legacy
The default, used when the `container` field is absent.
Expand Down Expand Up @@ -1049,6 +1053,7 @@ A publisher MAY estimate an unknown final duration from the frame cadence, but M
- Compared existing track properties by parsed values rather than JSON serialization.
- Required exclusive DVR restart recovery to remove unreferenced group objects left by interrupted expiration.
- Replaced the catalog root `timeline` field with `archive`, carrying the timeline track plus optional `replay`, `store`, and recording `version`.
- A marker group of one empty frame declares a discontinuity. Empty groups mean nothing. Timestamps only move forward; a group below the live edge is malformed. A delivered sequence hole is a playhead event unless contiguous within 1 ms.

# Acknowledgments
{:numbered="false"}
Expand Down
Loading
Loading