Rust Web音频API

Web音频API的纯Rust实现，用于非浏览器环境

关于Web音频API

Web音频API (MDN文档) 提供了一个强大而灵活的系统来控制Web上的音频，允许开发者选择音频源、为音频添加效果、创建音频可视化、应用空间效果（如声像）等等。

我们的Rust实现将Web音频API与Web解耦。现在你可以在桌面应用、命令行工具、无头执行等场景中使用它。

使用示例

use web_audio_api::context::{AudioContext, BaseAudioContext};
use web_audio_api::node::{AudioNode, AudioScheduledSourceNode};

// 根据你的硬件设置优化的音频上下文
let context = AudioContext::default();

// 对于背景音乐，从本地文件读取
let file = std::fs::File::open("samples/major-scale.ogg").unwrap();
let buffer = context.decode_audio_data_sync(file).unwrap();

// 设置AudioBufferSourceNode
let mut src = context.create_buffer_source();
src.set_buffer(buffer);
src.set_loop(true);

// 创建一个双二阶滤波器
let biquad = context.create_biquad_filter();
biquad.frequency().set_value(125.);

// 连接音频节点
src.connect(&biquad);
biquad.connect(&context.destination());

// 播放缓冲区
src.start();

// 欣赏音乐
std::thread::sleep(std::time::Duration::from_secs(4));

查看文档了解更多信息。

规范遵从性

我们尽可能严格遵守官方W3C规范，但一些偏差是不可避免的：

命名：使用snake_case而不是CamelCase
使用getter/setter方法而不是暴露属性
引入了一些命名空间
继承通过trait来建模

绑定

我们在https://github.com/ircam-ismm/node-web-audio-api提供了这个库的NodeJS绑定，因此你可以通过简单编写原生NodeJS代码来使用这个库。

这使我们能够运行官方的WebAudioAPI测试套件并追踪我们的规范遵从性得分。

音频后端

默认情况下，使用cpal库进行跨平台音频I/O。

我们通过cubeb特性标志为cubeb后端提供实验性支持。请注意，为了运行cubeb，必须在本地安装cmake。

特性标志	后端
cpal（默认）	ALSA、WASAPI、CoreAudio、Oboe（Android）
cpal-jack	JACK
cpal-asio	ASIO 参见 https://github.com/rustaudio/cpal#asio-on-windows
cubeb	PulseAudio、AudioUnit、WASAPI、OpenSL、AAudio、sndio、Sun、OSS

Linux用户注意事项

在Linux上使用ALSA后端的库可能会导致意外的刺耳声音（默认渲染大小为128帧）。在这种情况下，一个简单的解决方法是在创建音频上下文时传递AudioContextLatencyCategory::Playback延迟提示，这将增加渲染大小到1024帧：

let audio_context = AudioContext::new(AudioContextOptions {
    latency_hint: AudioContextLatencyCategory::Playback,
    ..AudioContextOptions::default()
});

对于需要低延迟的实时和交互式应用，你应该使用cpal提供的JACK后端。为此，你需要一个运行中的JACK服务器，并使用cpal-jack特性构建你的应用，例如cargo run --release --features "cpal-jack" --example microphone。