• Dynamic：每个通道都存储在自己的堆分配中。因此 [1, 2, 3, 4] 和 [5, 6, 7, 8]。这可能在频繁调整大小时性能更好。通常更倾向于使用其他缓冲区类型以获得更好的CPU缓存局部性。
• Interleaved：每个通道的样本在一个堆分配中交错存储。因此 [1, 5, 2, 6, 3, 7, 4, 8]。
• Sequential：每个通道在一个堆分配中依次存储。因此 [1, 2, 3, 4, 5, 6, 7, 8]。

这些都实现了 Buf 和 BufMut 特性，允许库作者抽象任何特定格式。缓冲区的确切通道和帧数称为其 拓扑。以下示例分配了具有4帧和2通道的缓冲区。缓冲区在内存中的排列方式不同，但使用相同的API将数据复制到它们中。

use audio::{BufMut, ChannelMut};

let mut dynamic = audio::dynamic![[0i16; 4]; 2];
let mut interleaved = audio::interleaved![[0i16; 4]; 2];
let mut sequential = audio::sequential![[0i16; 4]; 2];

audio::channel::copy_iter(0i16.., dynamic.get_mut(0).unwrap());
audio::channel::copy_iter(0i16.., interleaved.get_mut(0).unwrap());
audio::channel::copy_iter(0i16.., sequential.get_mut(0).unwrap());

我们还支持 wrapping 外部缓冲区，以便它们可以与其他音频缓冲区交互操作。

示例： play-mp3

使用 minimp3-rs、cpal 和 rubato 播放mp3文件以进行重采样。

此示例可以处理任何通道和采样率配置。

cargo run --release --package audio-examples --bin play-mp3 -- path/to/file.mp3

示例

use rand::Rng;

let mut buf = audio::buf::Dynamic::<f32>::new();

buf.resize_channels(2);
buf.resize_frames(2048);

/// Fill both channels with random noise.
let mut rng = rand::thread_rng();
rng.fill(&mut buf[0]);
rng.fill(&mut buf[1]);

为了方便，我们还提供了一些宏来构建各种动态音频缓冲区形式。这些主要用于测试。

let mut buf = audio::buf::Dynamic::<f32>::with_topology(4, 8);

for mut channel in &mut buf {
    for f in channel.iter_mut() {
        *f = 2.0;
    }
}

assert_eq! {
    buf,
    audio::dynamic![[2.0; 8]; 4],
};

assert_eq! {
    buf,
    audio::dynamic![[2.0, 2.0, 2.0, 2.0, 2.0, 2.0, 2.0, 2.0]; 4],
};