Struct AudioInput 

pub struct AudioInput { /* private fields */ }

In-memory audio ready for a transcription provider.

Fields are private (JOE-1809). Construct with AudioInput::from_pcm / load_audio, or AudioInput::from_parts_unchecked for trusted internal decode paths. Prefer accessors over free mutation.

Implementations

impl AudioInput

pub fn from_parts_unchecked( source_path: PathBuf, samples: Arc<[f32]>, sample_rate: u32, duration_secs: f64, ) -> Self

Trusted construction after decode (no re-validation of every sample).

Prefer from_pcm for host-facing PCM. Callers must ensure finite samples, positive sample rate, and duration consistency.

pub fn source_path(&self) -> &Path

pub fn samples(&self) -> &Arc<[f32]>

pub fn sample_rate(&self) -> u32

pub fn duration_secs(&self) -> f64

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn from_pcm( samples: impl Into<Arc<[f32]>>, sample_rate: u32, ) -> Result<Self>

Build from pre-decoded mono PCM (e.g. mic capture). No ffmpeg, no disk I/O.

sample_rate must be WHISPER_SAMPLE_RATE (16 kHz). Resample upstream if needed.

pub fn from_pcm_with_limits( samples: impl Into<Arc<[f32]>>, sample_rate: u32, max_duration_secs: f64, max_decoded_bytes: usize, ) -> Result<Self>

Like from_pcm with explicit safety limits.

pub fn from_pcm_slice(samples: &[f32], sample_rate: u32) -> Result<Self>

Copy a slice into a new AudioInput (convenience for mic chunks already at 16 kHz).

Trait Implementations

impl Clone for AudioInput

fn clone(&self) -> AudioInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AudioInput

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

Formats the value using the given formatter.