Struct Info 

#[non_exhaustive]
pub struct Info {
    pub timescale: Timescale,
    pub latency_max: Duration,
    pub priority: u8,
    pub ordered: bool,
    /* private fields */
}

Publisher-side properties of a track.

These are fixed by the publisher when the track is created and don’t change while the track is alive. A subscriber learns them via broadcast::Consumer::track, which returns the publisher’s Info once the subscription is accepted.

Not Copy: it carries an internal handle to its parent broadcast.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

timescale: Timescale

Units per second for per-frame timestamps on this track.

Every track is timed; this defaults to Timescale::MILLI. On Lite05+ it is reported in TRACK_INFO and the publisher zigzag-delta encodes per-frame timestamps at this scale on the wire. Protocols whose wire can’t carry it (pre-Lite05 moq-lite, IETF moq-transport) fall back to local monotonic milliseconds.

latency_max: Duration

The maximum age of a non-latest group before the publisher evicts it (the newest group is always retained). A subscriber’s Subscription::latency_max window is clamped to this, since a group can’t be waited for longer than it’s kept around. Reported in TRACK_INFO so relays re-serve with the same window. Defaults to DEFAULT_LATENCY_MAX.

This is the Publisher Max Latency on the wire, the publisher-side half of the same budget Subscription::latency_max sets for a subscriber.

priority: u8

The publisher’s priority for this track, used only to break ties between subscriptions of equal subscriber priority. Reported in TRACK_INFO (Lite05+).

ordered: bool

Whether groups are prioritized in sequence order. Groups may always arrive out-of-order (or not at all) over the network. Used only to break ties, reported in TRACK_INFO (Lite05+), and defaults to false (newest-first).

Implementations

impl Info

pub fn with_timescale(self, timescale: Timescale) -> Self

Set the per-frame timestamp scale, returning self for chaining.

Defaults to Timescale::MILLI. On Lite05+ this scale is reported in TRACK_INFO and used to encode per-frame timestamps on the wire.

pub fn with_latency_max(self, latency_max: Duration) -> Self

Set the maximum age of a non-latest group before eviction, returning self for chaining.

pub fn with_priority(self, priority: u8) -> Self

Set the publisher’s tie-break priority, returning self for chaining.

pub fn with_ordered(self, ordered: bool) -> Self

Set whether groups are prioritized in sequence order, returning self for chaining. Groups may always arrive out-of-order (or not at all) over the network. Defaults to false.

Trait Implementations

impl Clone for Info

fn clone(&self) -> Info

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Info

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Info

fn default() -> Self

Returns the “default value” for a type.