Struct OpusConfig 

pub struct OpusConfig { /* private fields */ }

Opus audio codec configuration.

Implementations

impl OpusConfig

pub fn new() -> Self

Creates a new Opus configuration.

pub fn voice() -> Self

Voice/VOIP optimised preset.

Uses VOIP application mode, maximum complexity, VBR, and forward error correction — suitable for speech transmission over lossy networks.

pub fn music() -> Self

Music streaming preset.

Uses Audio application mode, maximum complexity, VBR, and a 20 ms frame duration — optimal balance for music with transparent quality.

pub fn fullband() -> Self

Full-band (20 Hz–20 kHz) audio preset.

Forces full-band mode with maximum complexity and VBR.

pub fn application(self, app: OpusApplication) -> Self

Sets the application type.

pub fn complexity(self, complexity: u8) -> Self

Sets the complexity (0-10).

pub fn frame_duration(self, duration_ms: f32) -> Self

Sets the frame duration in milliseconds.

pub fn vbr(self, enable: bool) -> Self

Enables variable bitrate.

pub fn with_vbr(self, enabled: bool) -> Self

Enables or disables variable bitrate via builder pattern.

pub fn with_constrained_vbr(self, enabled: bool) -> Self

Enables or disables constrained VBR mode.

Constrained VBR limits bitrate peaks while still allowing variation, giving better quality than strict CBR with bounded bitrate.

pub fn with_dtx(self, enabled: bool) -> Self

Enables or disables Discontinuous Transmission (DTX).

DTX reduces bitrate during silence by sending comfort noise packets, useful for VOIP applications where silence is frequent.

pub fn with_fec(self, enabled: bool) -> Self

Enables or disables in-band Forward Error Correction (FEC).

FEC adds redundant audio data that allows partial recovery from packet loss in VoIP scenarios. Increases bitrate slightly.

pub fn with_packet_loss_perc(self, pct: u8) -> Self

Sets the expected packet loss percentage (0–100).

This hint guides the encoder in tuning FEC strength and bitrate distribution. Requires FEC to be enabled for full effect.

pub fn build(self) -> CodecConfig

Converts to base codec config.

Trait Implementations

impl Clone for OpusConfig

fn clone(&self) -> OpusConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpusConfig

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

Formats the value using the given formatter.

impl Default for OpusConfig

fn default() -> Self

Returns the “default value” for a type.