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。

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。

针对浏览器

我们可以通过cpal的wasm-bindgen后端将Rust WebAudio输出重新输入到浏览器中，从而完成全循环。查看一个WASM项目示例。 警告：实验性功能！

贡献

web-audio-api-rs欢迎所有人以建议、错误报告、拉取请求和反馈的形式做出贡献。💛

如果你需要贡献的想法，有几种方法可以开始：

• 尝试我们的一些示例（位于examples/目录）并开始构建你自己的音频图
• 发现了bug或有功能请求？提交一个问题！
• 标记为good first issue的问题是相对简单的入门问题。

除非你明确声明，否则你有意提交以包含在web-audio-api-rs中的任何贡献，均应根据MIT许可证授权，不附加任何其他条款或条件。

许可证

本项目根据MIT许可证授权。

致谢

用于HRTF空间化的IR文件是Ircam EAC团队创建的LISTEN数据库的一部分。