flexaudio 0.7.0

Flexible cross-platform audio capture (microphone, system loopback, per-process) for Linux, Windows, and macOS with a unified API.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

//! Capture-open settings that do not change the audio stream configuration.

/// Optional backend behavior selected when opening or switching a stream.
#[non_exhaustive]
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct OpenOptions {
    /// Keep Windows classic system loopback active by rendering silence.
    ///
    /// Enabled by default. Applies to system capture and the system lane of a mix
    /// without process exclusions. Other operating systems and process-loopback
    /// paths ignore this setting.
    ///
    /// When disabled, an idle endpoint delivers no packets. The unchanged 2 s
    /// watchdog reports [`crate::Event::StreamStalled`] and reopens repeatedly
    /// until audio plays.
    pub windows_classic_loopback_keepalive: bool,
}

impl Default for OpenOptions {
    fn default() -> Self {
        Self {
            windows_classic_loopback_keepalive: true,
        }
    }
}

impl OpenOptions {
    /// Create the default options, including Windows classic loopback keepalive.
    pub fn new() -> Self {
        Self::default()
    }

    /// Enable or disable Windows classic loopback's silent-render keepalive.
    pub fn windows_classic_loopback_keepalive(mut self, enabled: bool) -> Self {
        self.windows_classic_loopback_keepalive = enabled;
        self
    }
}