Struct IdleDetector 

pub struct IdleDetector { /* private fields */ }

Streaming idle detector over 16 kHz mono samples.

Feed samples via IdleDetector::push; it buffers partial windows internally and only classifies a window once it is fully filled. IdleDetector::is_idle returns true once enough consecutive silent windows have accumulated. The detector also remembers whether any voiced window has ever been seen — the orchestrator uses that flag to fail loudly on all-silence recordings (muted mic, etc.) rather than emit a near-empty WAV that downstream Whisper would crash on.

Implementations

impl IdleDetector

pub fn new(idle_after_secs: u32) -> Self

Builds a detector that fires after idle_after_secs seconds of uninterrupted silence on the 16 kHz stream.

pub fn idle_after_secs(&self) -> u32

Returns the configured idle-after threshold in seconds.

pub fn push(&mut self, samples: &[f32]) -> Vec<WindowClass>

Feeds new samples; processes whatever windows are complete and updates internal state. Returns the classifications of windows completed by this call (oldest first) so callers can log or instrument them.

pub fn is_idle(&self) -> bool

Returns true once idle_after_secs consecutive silent windows have arrived. (At 100 ms per window, that’s 10 * idle_after_secs windows.) Always false before idle_after_secs == 0 — a zero threshold disables auto-stop.

pub fn has_any_voice(&self) -> bool

Returns true if at least one voiced window has been observed since construction.

pub fn trailing_silence_samples(&self) -> usize

Number of samples to drop from the tail of the stream when the detector has fired — exactly the silent window streak that caused is_idle to flip true.