Struct Repacketizer 

pub struct Repacketizer { /* private fields */ }

opus_repacketizer: accumulate frames from one or more same-config packets, then emit them as a single re-framed packet.

Implementations

impl Repacketizer

pub fn new() -> Self

An empty repacketizer, holding no frames.

pub fn clear(&mut self)

Drop every frame, keeping the buffers that held them.

This is what makes one repacketizer reusable across packets. Building a fresh Repacketizer::new per packet is correct but allocates a buffer per frame every time; clearing and refilling one reuses them.

pub fn nb_frames(&self) -> usize

Frames accumulated so far by cat.

Also the upper bound for out_range, which is how a packet is split rather than joined.

pub fn cat(&mut self, data: &[u8]) -> Result<()>

Append the frames of data (opus_repacketizer_cat). Errors if the TOC config differs from frames already held, or the 120 ms cap is exceeded.

pub fn out_range(&self, begin: usize, end: usize) -> Result<Vec<u8>>

Emit frames [begin, end) as one packet (opus_repacketizer_out_range).

pub fn out(&self) -> Result<Vec<u8>>

Emit all held frames (opus_repacketizer_out).

pub fn out_into(&self, out: &mut Vec<u8>) -> Result<()>

out, appended to out instead of allocating.

The _into forms exist because every other one hands back a fresh Vec, which is an allocation per packet a caller in a steady loop can do without. They append, so one buffer can accumulate several packets.

pub fn out_range_into( &self, begin: usize, end: usize, out: &mut Vec<u8>, ) -> Result<()>

out_range, appended to out.

pub fn out_self_delimited_into(&self, out: &mut Vec<u8>) -> Result<()>

out_self_delimited, appended to out.

pub fn out_self_delimited(&self) -> Result<Vec<u8>>

Emit all frames with the self-delimited framing multistream uses (the last frame’s length is coded so the packet’s total size is derivable).

Trait Implementations

impl Debug for Repacketizer

Shows what the repacketizer holds without printing the frames themselves, which are compressed audio and unreadable either way.

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

Formats the value using the given formatter.

impl Default for Repacketizer

fn default() -> Repacketizer

Returns the “default value” for a type.