Oboe库的Rust绑定

为Oboe提供安全Rust接口，它是Android上的高性能音频库。它还提供了对一些对音频I/O重要的平台API的接口。

Oboe是一个C++库，使得在Android上构建高性能音频应用变得简单。它主要是为了允许开发人员针对一个简化API，该API可以在多个API级别上工作，直到API级别16（Jelly Bean）。

Crate特性

• java-interface 为某些Android平台API添加接口。
• generate-bindings 在编译时生成绑定。默认情况下，将使用预生成的绑定。
• compile-library 使用cmake在编译时编译oboe C++库。默认情况下，将使用预编译的库。
• shared-link 使用共享链接。默认情况下，将使用静态Oboe库。

该Crate已为以下Android目标预生成绑定和预编译静态库

• armv7
• aarch64
• i686
• x86_64

构建问题

clang-sys Crate使用llvm-config来搜索libclang库并为C/C++编译器配置准备。为了获得正确的设置，您应该将llvm-config添加到您的可执行文件搜索路径中。

如果您使用的是像bindgen这样的底层使用libclang的工具，您必须确保您的设置正确。否则，您将遇到与缺失头文件或定义相关的错误。

为了构建应用程序，您需要一个最新的cargo-apk版本，它支持最新的Android SDK (28+) 和 NDK (20+)。不要忘记使用安装的SDK路径设置ANDROID_SDK_ROOT环境变量。

对于需要C编译器的宿主Crate的构建，您也可以设置HOST_CC环境变量，以C编译器的路径。

使用示例

异步（回调驱动）模式播放正弦波

use oboe::{
    AudioOutputCallback,
    AudioOutputStream,
    AudioStreamBuilder,
    DataCallbackResult,
    PerformanceMode,
    SharingMode,
    Mono,
};

// Structure for sound generator
pub struct SineWave {
    frequency: f32,
    gain: f32,
    phase: f32,
    delta: Option<f32>,
}

// Default constructor for sound generator
impl Default for SineWave {
    fn default() -> Self {
        Self {
            frequency: 440.0,
            gain: 0.5,
            phase: 0.0,
            delta: None,
        }
    }
}

// Audio output callback trait implementation
impl AudioOutputCallback for SineWave {
    // Define type for frames which we would like to process
    type FrameType = (f32, Mono);

    // Implement sound data output callback
    fn on_audio_ready(&mut self, stream: &mut dyn AudioOutputStream, frames: &mut [f32]) -> DataCallbackResult {
        // Configure out wave generator
        if self.delta.is_none() {
            let sample_rate = stream.get_sample_rate() as f32;
            self.delta = (self.frequency * 2.0 * PI / sample_rate).into();
            println!("Prepare sine wave generator: samplerate={}, time delta={}", sample_rate, self.delta.unwrap());
        }

        let delta = self.delta.unwrap();

        // Generate audio frames to fill the output buffer
        for frame in frames {
            *frame = self.gain * self.phase.sin();
            self.phase += delta;
            while self.phase > 2.0 * PI {
                self.phase -= 2.0 * PI;
            }
        }

        // Notify the oboe that stream is continued
        DataCallbackResult::Continue
    }
}

// ...

// Create playback stream
let mut sine = AudioStreamBuilder::default()
    // select desired performance mode
    .set_performance_mode(PerformanceMode::LowLatency)
    // select desired sharing mode
    .set_sharing_mode(SharingMode::Shared)
    // select sound sample format
    .set_format::<f32>()
    // select channels configuration
    .set_channel_count::<Mono>()
    // set our generator as callback
    .set_callback(SineWave::default())
    // open the output stream
    .open_stream()
    .unwrap();

// Start playback
sine.start().unwrap();

// ...