Struct EmsgBox 

pub struct EmsgBox<'a> {
    pub scheme_id_uri: &'a str,
    pub value: &'a str,
    pub timescale: u32,
    pub presentation_time: PresentationTime,
    pub event_duration: u32,
    pub id: u32,
    pub message_data: &'a [u8],
}

A parsed/owned MPEG-DASH Event Message Box (emsg).

Holds the typed FullBox body fields plus borrowed views of the two null-terminated UTF-8 strings and the opaque message_data. The box size and version are not stored: size is recomputed on serialize and version is derived from PresentationTime, so the round-trip is driven entirely from the typed fields (no raw passthrough).

Fields

scheme_id_uri: &'a str

scheme_id_uri (Table 6-2): the URI defining the event scheme. Stored without the wire 0x00 terminator.

value: &'a str

value (Table 6-2): scheme-specific value, or the empty string when the scheme defines none. Stored without the wire 0x00 terminator.

timescale: u32

timescale (Table 6-2, u32): ticks per second for the time fields; equal to the mdhd timescale of the Representation.

presentation_time: PresentationTime

The presentation-time field — selects the box version (v0 delta vs v1 absolute).

event_duration: u32

event_duration (Table 6-2, u32): event duration in timescale units.

id: u32

id (Table 6-2, u32): unique identifier distinguishing events with the same scheme_id_uri/value and detecting repetitions.

message_data: &'a [u8]

message_data[] (Table 6-2): the opaque scheme-specific payload (the remaining bytes of the box). Empty when the scheme needs none.

Implementations

impl<'a> EmsgBox<'a>

pub fn version(&self) -> EmsgVersion

The version of this box, derived from Self::presentation_time.

pub fn is_scte35(&self) -> bool

true if scheme_id_uri names a SCTE 35 scheme (urn:scte:scte35...), in which case Self::message_data carries a SCTE 35 splice_info_section (SCTE 214-1 / ANSI/SCTE 35 — see crate root).

pub fn serialized_len(&self) -> usize

Total serialized size in bytes (the size field value).

pub fn parse(data: &'a [u8]) -> Result<EmsgBox<'a>, Error>

Parse an emsg box from the start of data. Requires the full box (size bytes) to be present; trailing bytes beyond size are ignored.

pub fn serialize_into(&self, out: &mut [u8]) -> Result<usize, Error>

Serialize the box into out, recomputing the size field and writing flags = 0. Returns the number of bytes written.

pub fn to_vec(&self) -> Result<Vec<u8>, Error>

Serialize into a freshly allocated Vec.

Trait Implementations

impl<'a> Clone for EmsgBox<'a>

fn clone(&self) -> EmsgBox<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for EmsgBox<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for EmsgBox<'a>

impl<'a> PartialEq for EmsgBox<'a>

fn eq(&self, other: &EmsgBox<'a>) -> 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<'a> Serialize for EmsgBox<'a>

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> StructuralPartialEq for EmsgBox<'a>