Struct AudioInput 

pub struct AudioInput {
    _host: Host,
    _device: Device,
    _stream: Stream,
    buffer: Arc<Mutex<Vec<f32>>>,
    sample_rate: u32,
}

Real-time audio input capture.

Fields

_host: Host

Audio host

_device: Device

Input device

_stream: Stream

Input stream

buffer: Arc<Mutex<Vec<f32>>>

Shared buffer for audio samples

sample_rate: u32

Sample rate

Implementations

impl AudioInput

pub fn list_input_devices() -> Vec<String>

Enumerate the names of every input device offered by cpal’s default host. Used by the GUI’s Options panel to populate the audio device picker. Devices that fail name() (rare — usually disconnected mid-enumeration) are silently skipped.

Prefer list_sources when callers want the monitor/microphone classification flags (CLI list-audio subcommand, future GUI picker).

pub fn new() -> Result<Self>

Create a new audio input capture.

pub fn with_device(name: Option<&str>) -> Result<Self>

Create a new audio input capture targeting a specific device by name. name = None triggers the music-visualizer autodetect: the monitor of the host’s default output sink is preferred over the host default input (the microphone), so a fresh install reacts to playing music without any GUI / CLI configuration. See detect_default_source for the full preference order. Unknown names log a warning and fall back to the same autodetect.

pub fn get_samples(&self) -> Vec<f32>

Get the latest audio samples. Returns a copy of the current buffer.

pub fn sample_rate(&self) -> u32

Get the sample rate.

pub fn get_fixed_samples(&self, count: usize) -> Vec<f32>

Get a fixed number of samples for processing. If not enough samples are available, returns zeros.