Expand description
DashConfig: the DASH-specific knobs of a client session.
docs/dash-runtime/DESIGN.md 6.4 (fields and defaults), 3.2-3.4 (clock
ladder), 5.2 (refresh floor), 5.4 (early-request cadence), D9 (LL-DASH) and
10.2 R3 (cross-origin restriction). Pure data: nothing here reads a clock.
Every duration is in microseconds. A value of u64::MAX is accepted
wherever zero is not: consumers combine these with saturating arithmetic,
so MAX reads as “never” or “unbounded” rather than overflowing.
Structs§
- Dash
Config - DASH-specific configuration. The knobs shared with every segment-pull source (redirects, headers, cookies, backoff, in-flight window, body caps, playout, timeline-jump detection) stay on the session’s own config.
- Dash
Config Error - A
DashConfigfield no client can run with. - Pull
Limits - The knobs every segment-pull source shares (DESIGN 6.4, “shared with
HLS”): the session owns them in its own config and passes them in; they
are deliberately not part of
DashConfig. - Pull
Limits Error - A rejected
PullLimits.
Enums§
- Dash
Clock Policy - Which clock source the ladder tries first for a dynamic MPD.
Constants§
- DEFAULT_
AVAILABILITY_ MARGIN_ US - Default margin added to a segment’s availability start before requesting it.
- DEFAULT_
EARLY_ GRACE_ US - Default window after a segment’s availability start in which a 404, 410 or 425 still means “too early” rather than “missing”.
- DEFAULT_
EARLY_ RETRY_ US - Default first retry delay for a segment requested before it exists.
- DEFAULT_
HOST_ CLOCK_ UNCERTAINTY_ US - Default error bar reported for a host-supplied clock.
- DEFAULT_
MAX_ INFLIGHT_ SEGMENTS - Default number of segment requests kept outstanding at once.
- DEFAULT_
MAX_ INIT_ FAILURES - Default consecutive failures of one init or index resource before the presentation is given up on.
- DEFAULT_
MAX_ SEGMENT_ BYTES - Default bound on one fetched resource body (init, index or segment).
- DEFAULT_
MAX_ SEGMENT_ FAILURES - Default consecutive failures of one segment before it is given up on.
- DEFAULT_
MIN_ MPD_ REFRESH_ US - Default floor under the MPD refresh interval.
- DEFAULT_
UTC_ MAX_ RTT_ US - Default longest round trip a
UTCTimingsample may have and still be used. - DEFAULT_
UTC_ RESYNC_ US - Default age after which a same-source clock anchor is replaced.
- DEFAULT_
UTC_ TIMEOUT_ US - Default time one
UTCTimingrequest may take. - DEFAULT_
UTC_ WAIT_ US - Default total wait for a
UTCTimingsample before the clock ladder falls through to the next source.