Struct AudioHandler 

pub struct AudioHandler { /* private fields */ }

Concrete implementation of AudioHandlerTrait backed by real CPAL devices.

AudioHandler owns the input device, output device, and stream configuration required to build CPAL streams. It is cheaply cloneable so that it can be shared across threads via Arc.

Implementations

impl AudioHandler

Auto-generated by derive_getters::Getters.

pub fn input_device(&self) -> &Device

Get field input_device from instance of AudioHandler.

pub fn output_device(&self) -> &Device

Get field output_device from instance of AudioHandler.

pub fn input_config(&self) -> &StreamConfig

Get field input_config from instance of AudioHandler.

pub fn output_config(&self) -> &StreamConfig

Get field output_config from instance of AudioHandler.

pub fn input_sample_rate(&self) -> &u32

Get field input_sample_rate from instance of AudioHandler.

pub fn output_sample_rate(&self) -> &u32

Get field output_sample_rate from instance of AudioHandler.

impl AudioHandler

pub fn new( input_device: Device, output_device: Device, input_config: StreamConfig, output_config: StreamConfig, ) -> Self

Creates a new AudioHandler with the given CPAL devices and stream config.

Arguments

• input_device - The CPAL device used to capture audio.
• output_device - The CPAL device used to play back audio.
• input_config - The [StreamConfig] used for the input stream.
• output_config - The [StreamConfig] used for the output stream.

pub fn create_ringbuffer(size: usize) -> (HeapProd<f32>, HeapCons<f32>)

Creates a lock-free ring buffer of f32 samples with the given capacity.

Returns a (producer, consumer) pair that can be moved into separate threads for wait-free, single-producer/single-consumer audio transfer.

Arguments

• size - The number of f32 samples the ring buffer can hold.

pub fn set_output_device(&mut self, output_device: Device)

Replaces the current output device.

Arguments

• output_device - The new CPAL output device.

pub fn set_input_device(&mut self, input_device: Device)

Replaces the current input device.

Arguments

• input_device - The new CPAL input device.

Trait Implementations

impl AudioHandlerTrait for AudioHandler

fn build_input_stream(&self, producer: HeapProd<f32>) -> Box<dyn PlayableStream>

Builds a CPAL input stream that forwards every captured sample into the provided ring-buffer producer.

Samples that cannot be pushed (i.e. the ring buffer is full) are silently dropped. Input errors are added to logs as error.

Panics

Panics if CPAL fails to build the input stream.

fn build_output_stream( &self, consumer: HeapCons<f32>, ) -> Box<dyn PlayableStream>

Builds a CPAL output stream that drains samples from the provided ring-buffer consumer into the hardware output buffer.

Any output slot that has no corresponding sample is filled with 0.0 (silence). Output errors are printed to stderr.

Panics

Panics if CPAL fails to build the output stream.

fn input_device(&self) -> &Device

Returns a reference to the CPAL input device used by this handler.

fn output_device(&self) -> &Device

Returns a reference to the CPAL output device used by this handler.

fn input_config(&self) -> &StreamConfig

Returns the [StreamConfig] used for the input stream.

fn output_config(&self) -> &StreamConfig

Returns the [StreamConfig] used for the output stream.

fn input_sample_rate(&self) -> u32

Returns the configured input sample rate in Hz.

fn output_sample_rate(&self) -> u32

Returns the configured output sample rate in Hz.

impl Clone for AudioHandler

fn clone(&self) -> AudioHandler

Returns a duplicate of the value.

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

Performs copy-assignment from source.