Struct Audio 

pub struct Audio { /* private fields */ }

Implementations

impl Audio

pub fn new() -> Result<Audio, Error>

Create the audio subsystem. On native targets this opens the output device immediately; on the web it defers that to Audio::start.

pub fn start(&mut self) -> Result<(), Error>

Open the output device if it isn’t open yet. Idempotent. On the web this must run inside a user-gesture handler, otherwise the browser keeps the AudioContext muted.

pub fn is_started(&self) -> bool

Whether the output device is open, i.e. Audio::play can produce sound.

pub fn load_sound(&mut self, path: impl AsRef<Path>) -> Result<SoundId, Error>

Load a sound file from disk. Not available on the web; use Audio::load_sound_bytes.

pub fn load_sound_bytes( &mut self, bytes: impl Into<Vec<u8>>, ) -> Result<SoundId, Error>

Decode an encoded sound file (wav, ogg, flac, mp3) held in memory.

pub fn play(&mut self, id: SoundId) -> Result<StaticSoundHandle, Error>

pub fn play_samples( &mut self, samples: &[f32], sample_rate: u32, ) -> Result<StaticSoundHandle, Error>

Play mono PCM samples (-1.0..=1.0) directly, e.g. a buffer rendered by [Synth]. The samples are duplicated to both channels.

pub fn set_master_volume(&mut self, volume: f32)

Master volume on the default main track, as a linear amplitude (1.0 is unity gain, 0.0 is silence). Converted to decibels for kira.