cpvc 0.6.0

A simple crate + wrapper for controlling system audio cross platform
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

pub mod device;

// #[cfg(not(target_os="windows"))]
#[cfg(target_os="windows")]
pub mod wasapi {
    use windows::core::PWSTR;
    use windows::Win32::System::Com::CLSCTX_ALL;
    use windows::Win32::Media::Audio::Endpoints::IAudioEndpointVolume;
    use windows::Win32::Media::Audio::{DEVICE_STATE_ACTIVE, IMMDevice, eMultimedia, eRender};
    use windows::Win32::Devices::FunctionDiscovery::PKEY_Device_FriendlyName;
    use windows::Win32::System::Com::STGM_READ;
    use crate::VolumeControl;
    use crate::device::DeviceTrait;
    use crate::wasapi::device::WASAPIDevice;
    use crate::{debug_eprintln, error::Error};
        
    pub fn get_device_identifiers() -> Result<Vec<(String, String)>, Error> {
        let mut devices: Vec<(String, String)> = Vec::new();
        unsafe {
            let enumerator = get_enumerator();
            let device_col = enumerator.EnumAudioEndpoints(eRender, DEVICE_STATE_ACTIVE).unwrap();
            let dev_count = device_col.GetCount().unwrap();
            for device_id in 0..dev_count{
                let device = device_col.Item(device_id).unwrap();
                let result = device.OpenPropertyStore(STGM_READ);
                match result {
                    Ok(properties) => {
                        let name = properties.GetValue(&PKEY_Device_FriendlyName).unwrap();
                        let uid = get_imm_device_uid(&IMMWrapper { device })?;
                        devices.push((uid, name.to_string()));
                        // dbg!(properties.GetValue(&PKEY_Device_FriendlyName));
                    },
                    Err(error) => {
                        return Err(Error::DeviceEnumerationFailed(format!("Failed to get audio devices {error}")))
                    }
                }
            }
        }
        Ok(devices)
    }

    pub(super) unsafe fn get_enumerator() -> windows::Win32::Media::Audio::IMMDeviceEnumerator {
        use windows::core::{Error};
        use windows::Win32::Media::Audio::IMMDeviceEnumerator;
        use windows::Win32::Media::Audio::{MMDeviceEnumerator};
        use windows::Win32::System::Com::{CoCreateInstance, CoInitializeEx, CLSCTX_ALL, COINIT_MULTITHREADED};

        unsafe {
            let _ = CoInitializeEx(None, COINIT_MULTITHREADED).unwrap();
            let hresult: Result<IMMDeviceEnumerator, Error> = CoCreateInstance(&MMDeviceEnumerator, None, CLSCTX_ALL);
            match hresult {
                Ok(devices) => {
                    devices
                },
                Err(error) => {
                    panic!("{}", error);
                }
            }
        }
    }

    pub fn get_default_output_device() -> Result<WASAPIDevice, Error> {
        let default_device;
        unsafe {
            let enumerator = get_enumerator();
            default_device = enumerator.GetDefaultAudioEndpoint(eRender, eMultimedia).unwrap();
        }
        Ok(WASAPIDevice::from_imm_device(IMMWrapper {device: default_device})?)
    }

    pub fn get_imm_device_uid(wrapper: &IMMWrapper) -> Result<String, Error> {
        unsafe {
            Ok(wrapper.device.GetId().map_err(|e| Error::DeviceAccessFailed(format!("Failed to get Device Id {e}")))?
                .to_string().map_err(|e| Error::DeviceAccessFailed(format!("PWSTR conversion failed {e}")))?)
        }
    }

    // Volume Controls 
    pub fn get_sound_devices() -> Result<Vec<String>, Error> {
        Ok(get_device_identifiers()?.into_iter().map(|(_pwstr, name)| name).collect())
    }

    pub fn get_vol() -> Result<f32, Error> {
        let default_device = get_default_output_device()?;
        Ok(default_device.get_vol()?)
    }

    pub fn set_vol(value: f32) -> Result<(), Error> {
        let default_device = get_default_output_device()?;
        Ok(default_device.set_vol(value)?)
    }

    pub fn get_mute() -> Result<bool, Error> {
        let default_device = get_default_output_device()?;
        Ok(default_device.get_mute()?)
    }

    pub fn set_mute(state: bool) -> Result<(), Error> {
        let default_device = get_default_output_device()?;
        Ok(default_device.set_mute(state)?)
    }

    pub struct IMMWrapper {
        #[cfg(target_os="windows")]
        pub device: IMMDevice,
    }

    pub struct EnumeratorWrapper {
        pub enumerator: windows::Win32::Media::Audio::IMMDeviceEnumerator
    }
}

// #[cfg(target_os="windows")]
#[cfg(not(target_os="windows"))]
pub mod wasapi {
    use crate::{error::Error, wasapi::device::WASAPIDevice};

     pub fn get_device_identifiers() -> Result<Vec<(String, String)>, Error> {
        Err(Error::PlatformUnsupported)
    }


    pub fn get_default_output_device() -> Result<WASAPIDevice, Error> {
        Err(Error::PlatformUnsupported)
    }

    pub fn get_imm_device_uid(wrapper: &IMMWrapper) -> Result<String, Error> {
        Err(Error::PlatformUnsupported)
    }

    // Volume Controls 
    pub fn get_sound_devices() -> Result<Vec<String>, Error> {
        Err(Error::PlatformUnsupported)
    }

    pub fn get_vol() -> Result<f32, Error> {
        Err(Error::PlatformUnsupported)
    }

    pub fn set_vol(value: f32) -> Result<(), Error> {
        Err(Error::PlatformUnsupported)
    }

    pub fn get_mute() -> Result<bool, Error> {
        Err(Error::PlatformUnsupported)
    }

    pub fn set_mute(state: bool) -> Result<(), Error> {
        Err(Error::PlatformUnsupported)
    }

    pub struct IMMWrapper {}

}

pub(crate) use wasapi::*;