Struct Track 

#[non_exhaustive]
pub struct Track {

    pub name: String,
    pub packaging: Packaging,
    pub is_live: bool,
    pub role: Option<Role>,
    pub codec: Option<String>,
    pub width: Option<u32>,
    pub height: Option<u32>,
    pub framerate: Option<f64>,
    pub samplerate: Option<u32>,
    pub channel_config: Option<String>,
    pub bitrate: Option<u64>,
    pub init_data: Option<String>,
    pub render_group: Option<u32>,
    pub alt_group: Option<u32>,
    pub max_grp_sap_starting_type: Option<u8>,
    pub max_obj_sap_starting_type: Option<u8>,
    pub jitter: Option<f64>,
}

A single track in the MSF catalog.

Marked #[non_exhaustive] because the CMSF/MSF drafts continue to grow optional fields. External callers build a track with Track::new and then assign whichever optional fields they need; struct-literal construction (with or without ..base) is not available outside this crate.

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.

name: String

Unique track name (case-sensitive).

packaging: Packaging

Packaging mode.

is_live: bool

Whether new objects will be appended.

role: Option<Role>

Content role.

codec: Option<String>

WebCodecs codec string.

width: Option<u32>

Video frame width in pixels.

height: Option<u32>

Video frame height in pixels.

framerate: Option<f64>

Video frame rate.

samplerate: Option<u32>

Audio sample rate in Hz.

channel_config: Option<String>

Audio channel configuration.

bitrate: Option<u64>

Bitrate in bits per second.

init_data: Option<String>

Base64-encoded initialization data.

render_group: Option<u32>

Render group for synchronized playback.

alt_group: Option<u32>

Alternate group for quality switching.

max_grp_sap_starting_type: Option<u8>

Maximum SAP starting type for groups (CMSF 3.5.2). A value of 1 means every group starts with a closed-GOP IDR.

max_obj_sap_starting_type: Option<u8>

Maximum SAP starting type for objects (CMSF 3.5.2). A value of 1 means every object starts with a closed-GOP IDR.

jitter: Option<f64>

Jitter in milliseconds (non-standard extension, matches JS implementation).

Implementations

impl Track

pub fn new(name: impl Into<String>, packaging: Packaging) -> Self

Construct a track with the required identity fields set and every optional field cleared. Fields are pub, so callers set whatever they need by assignment afterwards.

This is the only path external crates have to build a Track since the type is #[non_exhaustive].

Trait Implementations

impl Clone for Track

fn clone(&self) -> Track

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Track

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Track

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Track

fn eq(&self, other: &Track) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Track

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Track