bevy_mod_audio 0.1.0

streaming spatial audio and microphone support for bevy
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

use bevy::app::App;
use bevy::math::Vec3;
#[allow(deprecated)]
use bevy::prelude::{Changed, Component, GlobalTransform, Query, Update, With};
use bevy::prelude::{Single, Transform};
use cpal::FromSample;
use rodio::{Sample, Source};

pub struct SpatialAudioPlugin;

impl bevy::prelude::Plugin for SpatialAudioPlugin {
    fn build(&self, app: &mut App) {
        app.add_systems(Update, set_spatial_audio_sink_pos);
    }
}

#[derive(Component)]
pub struct Ears {
    pub left: Vec3,
    pub right: Vec3,
}

impl Default for Ears {
    fn default() -> Self {
        Self {
            left: Vec3::X * 4.0 / -2.0,
            right: Vec3::X * 4.0 / 2.0,
        }
    }
}

#[derive(Component)]
#[require(Transform)]
pub struct SpatialAudioSink {
    pub(crate) sink: rodio::SpatialSink,
}

impl SpatialAudioSink {
    #[inline]
    pub fn append<S>(&self, source: S)
    where
        S: Source + Send + 'static,
        f32: FromSample<S::Item>,
        S::Item: Sample + Send,
    {
        self.sink.append(source);
    }
}

/// Only a single one of these at a time in an app
/// This is the audio listener, where the imaginary microphone is that receives all sound
#[derive(Component)]
#[require(Transform)]
#[require(Ears)]
pub struct SpatialAudioListener;

fn set_spatial_audio_sink_pos(
    mut spatial_audio_sinks: Query<
        (&mut SpatialAudioSink, &GlobalTransform),
        Changed<GlobalTransform>,
    >,
    listener: Option<Single<(&GlobalTransform, &Ears), With<SpatialAudioListener>>>,
) {
    let Some(listener) = listener else { return };
    let (listener_position, ears) = (listener.0, listener.1);

    for (spatial_audio_sink, global_transform) in spatial_audio_sinks.iter_mut() {
        spatial_audio_sink.sink.set_emitter_position(
            (listener_position.translation() - global_transform.translation()).to_array(),
        );
        spatial_audio_sink
            .sink
            .set_left_ear_position(ears.left.to_array());
        spatial_audio_sink
            .sink
            .set_right_ear_position(ears.right.to_array());
    }
}