Struct sdl2::audio::AudioDevice

pub struct AudioDevice<CB: AudioCallback> { /* fields omitted */ }

Wraps SDL_AudioDeviceID and owns the callback data used by the audio device.

Methods

impl<CB: AudioCallback> AudioDevice<CB>

pub fn open_playback<'a, F, D>(
    a: &AudioSubsystem,
    device: D,
    spec: &AudioSpecDesired,
    get_callback: F
) -> Result<AudioDevice<CB>, String> where
    F: FnOnce(AudioSpec) -> CB,
    D: Into<Option<&'a str>>, 

Opens a new audio device for playback (given the desired parameters and callback).

If you want to modify the callback-owned data at a later point (for example to update its data buffer) you're likely to be interested in the lock method.

pub fn open_capture<'a, F, D>(
    a: &AudioSubsystem,
    device: D,
    spec: &AudioSpecDesired,
    get_callback: F
) -> Result<AudioDevice<CB>, String> where
    F: FnOnce(AudioSpec) -> CB,
    D: Into<Option<&'a str>>, 

Opens a new audio device for capture (given the desired parameters and callback). Supported since SDL 2.0.5

If you want to modify the callback-owned data at a later point (for example to update its data buffer) you're likely to be interested in the lock method.

pub fn subsystem(&self) -> &AudioSubsystem

pub fn spec(&self) -> &AudioSpec

pub fn status(&self) -> AudioStatus

pub fn pause(&self)

Pauses playback of the audio device.

pub fn resume(&self)

Starts playback of the audio device.

pub fn lock(&mut self) -> AudioDeviceLockGuard<CB>

Locks the audio device using SDL_LockAudioDevice.

When the returned lock guard is dropped, SDL_UnlockAudioDevice is called. Use this method to read and mutate callback data.

pub fn close_and_get_callback(self) -> CB

Closes the audio device and saves the callback data from being dropped.

Note that simply dropping AudioDevice will close the audio device, but the callback data will be dropped.