chore: update cpal to latest Git, fix conflict (#803)

* chore: update cpal to latest Git, replace `From<Input> for cpal::Device` with `into_inner`
* feat: enable U24 support from cpal
* chore: remove oboe backend support
* feat: filter actionable stream errors in example

---------

Co-authored-by: Roderick van Domburg <[email protected]>

Author: philpax

CHANGELOG.md

@@ -37,6 +37,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `Blue` noise generator uses uniform instead of Gaussian noise for better performance.
 - `Gaussian` noise generator has standard deviation of 0.6 for perceptual equivalence.
 - `Velvet` noise generator takes density in Hz as `usize` instead of `f32`.
+- Upgrade `cpal` to v0.17.
 
 ## Version [0.21.1] (2025-07-14)
 

Cargo.lock

@@ -46,8 +46,6 @@ noise = ["rand", "rand_distr"]
 #
 # Enable WebAssembly support for web browsers
 wasm-bindgen = ["cpal/wasm-bindgen"]
-# Use shared C++ stdlib on Android (reduces APK size, fixes linking issues)
-cpal-shared-stdcxx = ["cpal/oboe-shared-stdcxx"]
 
 # To decode an audio source with Rodio, you need to enable the appropriate features for *both* the
 # demuxer and the decoder.
@@ -106,7 +104,7 @@ all-features = true
 rustdoc-args = ["--cfg", "docsrs"]
 
 [dependencies]
-cpal = { version = "0.16", optional = true }
+cpal = { version = "0.17.0", optional = true }
 dasp_sample = "0.11.0"
 claxon = { version = "0.4.2", optional = true }
 hound = { version = "3.5", optional = true }

Cargo.toml

@@ -14,8 +14,11 @@ fn main() -> Result<(), Box<dyn Error>> {
 
     let stream_handle = rodio::OutputStreamBuilder::from_device(default_device)?
         .with_error_callback(move |err| {
-            // Filter for where err is a DeviceNotAvailable error.
-            if let cpal::StreamError::DeviceNotAvailable = err {
+            // Filter for where err is an actionable error.
+            if matches!(
+                err,
+                cpal::StreamError::DeviceNotAvailable | cpal::StreamError::StreamInvalidated
+            ) {
                 if let Err(e) = tx.send(err) {
                     eprintln!("Error emitting StreamError: {e}");
                 }
@@ -31,9 +34,10 @@ fn main() -> Result<(), Box<dyn Error>> {
     mixer.add(wave);
 
     if let Ok(err) = rx.recv_timeout(Duration::from_secs(30)) {
-        // Here we print the error that was emitted by the error callback.
-        // but in a real application we may want to destroy the stream and
-        // try to reopen it, either with the same device or a different one.
+        // Here we received an error that requires action from the error callback.
+        // In a real application you would destroy the stream and try to reopen it,
+        // either with the same device (for StreamInvalidated) or a different device
+        // (for DeviceNotAvailable).
         eprintln!("Error with stream {err}");
     }
 

examples/error_callback.rs

@@ -13,7 +13,7 @@ fn main() -> Result<(), Box<dyn Error>> {
     .prompt()?;
 
     let input = MicrophoneBuilder::new()
-        .device(input)?
+        .device(input.into_inner())?
         .default_config()?
         .open_stream()?;
 

examples/microphone.rs

@@ -91,7 +91,7 @@
 //!
 //! // Use a specific device (e.g., the second one)
 //! let mic = MicrophoneBuilder::new()
-//!     .device(inputs[1].clone())?
+//!     .device(inputs[1].clone().into_inner())?
 //!     .default_config()?
 //!     .open_stream()?;
 //! # Ok(())
@@ -130,23 +130,38 @@ pub struct Input {
     inner: cpal::Device,
 }
 
-impl From<Input> for cpal::Device {
-    fn from(val: Input) -> Self {
-        val.inner
+impl Input {
+    /// Consumes the input and returns the inner device.
+    pub fn into_inner(self) -> cpal::Device {
+        self.inner
     }
 }
 
 impl fmt::Debug for Input {
     fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
         f.debug_struct("Device")
-            .field("inner", &self.inner.name().unwrap_or("unknown".to_string()))
+            .field(
+                "inner",
+                &self
+                    .inner
+                    .description()
+                    .ok()
+                    .map_or("unknown".to_string(), |d| d.name().to_string()),
+            )
             .finish()
     }
 }
 
 impl fmt::Display for Input {
     fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
-        write!(f, "{}", self.inner.name().unwrap_or("unknown".to_string()))
+        write!(
+            f,
+            "{}",
+            self.inner
+                .description()
+                .ok()
+                .map_or("unknown".to_string(), |d| d.name().to_string())
+        )
     }
 }
 
@@ -271,8 +286,7 @@ impl Microphone {
             I64, i64;
             U8, u8;
             U16, u16;
-            // TODO: uncomment when https://github.com/RustAudio/cpal/pull/1011 is merged
-            // U24, cpal::U24;
+            U24, cpal::U24;
             U32, u32;
             U64, u64
         )