cpal 0.12.1

Low-level cross-platform audio I/O library in pure Rust.
Documentation 
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use super::alsa;
use super::Device;
use {BackendSpecificError, DevicesError};

/// ALSA implementation for `Devices`.
pub struct Devices {
    hint_iter: alsa::device_name::HintIter,
}

impl Devices {
    pub fn new() -> Result<Self, DevicesError> {
        Ok(Devices {
            hint_iter: alsa::device_name::HintIter::new_str(None, "pcm")?,
        })
    }
}

unsafe impl Send for Devices {}
unsafe impl Sync for Devices {}

impl Iterator for Devices {
    type Item = Device;

    fn next(&mut self) -> Option<Device> {
        loop {
            match self.hint_iter.next() {
                None => return None,
                Some(hint) => {
                    let name = hint.name;

                    let io = hint.direction;

                    if let Some(io) = io {
                        if io != alsa::Direction::Playback {
                            continue;
                        }
                    }

                    let name = match name {
                        Some(name) => {
                            // Ignoring the `null` device.
                            if name == "null" {
                                continue;
                            }
                            name
                        }
                        _ => continue,
                    };

                    // See if the device has an available output stream.
                    let has_available_output = {
                        let playback_handle =
                            alsa::pcm::PCM::new(&name, alsa::Direction::Playback, true);
                        playback_handle.is_ok()
                    };

                    // See if the device has an available input stream.
                    let has_available_input = {
                        let capture_handle =
                            alsa::pcm::PCM::new(&name, alsa::Direction::Capture, true);
                        capture_handle.is_ok()
                    };

                    if has_available_output || has_available_input {
                        return Some(Device(name));
                    }
                }
            }
        }
    }
}

#[inline]
pub fn default_input_device() -> Option<Device> {
    Some(Device("default".to_owned()))
}

#[inline]
pub fn default_output_device() -> Option<Device> {
    Some(Device("default".to_owned()))
}

impl From<alsa::Error> for DevicesError {
    fn from(err: alsa::Error) -> Self {
        let err: BackendSpecificError = err.into();
        err.into()
    }
}