Struct NoopAudioPlayer 

pub struct NoopAudioPlayer { /* private fields */ }

The player used when no backend is installed.

It still allocates real SoundIds and VoiceIds and remembers the volume and bus settings written to it, so app logic and settings screens behave identically with and without a device.

Implementations

impl NoopAudioPlayer

pub fn new() -> NoopAudioPlayer

Creates a player that accepts everything and produces no sound.

Trait Implementations

impl AudioPlayer for NoopAudioPlayer

fn load_clip(&self, _clip: AudioClip) -> Result<SoundId, AudioError>

Hands an already-decoded clip to the engine.

fn play(&self, _id: SoundId, _params: PlaybackParams)

Starts a one-shot voice. Re-triggering the same clip layers a new voice rather than restarting the old one.

fn play_loop(&self, id: SoundId, _params: PlaybackParams) -> VoiceId

Starts a looping voice and returns its handle.

fn stop(&self, _id: SoundId)

Stops every voice playing id.

fn stop_voice(&self, _voice: VoiceId)

Stops one voice.

fn set_master_volume(&self, volume: f32)

Sets the gain applied to every bus.

fn master_volume(&self) -> f32

The current master gain.

fn set_bus_volume(&self, bus: AudioBus, volume: f32)

Sets one bus’s gain.

fn bus_volume(&self, bus: AudioBus) -> f32

One bus’s gain.

fn set_bus_enabled(&self, bus: AudioBus, enabled: bool)

Mutes or unmutes a bus. This is the “sound on” / “music on” toggle; muting leaves voices running so unmuting resumes mid-track.

fn bus_enabled(&self, bus: AudioBus) -> bool

Whether a bus is audible.

fn load(&self, bytes: &[u8]) -> Result<SoundId, AudioError>

Decodes bytes and loads the result.

fn unload(&self, _id: SoundId)

Releases a clip. Voices already playing it are stopped.

fn stop_all(&self)

Stops every voice on every bus.

fn set_voice_params(&self, _voice: VoiceId, _params: PlaybackParams)

Retunes a voice while it plays — a looping engine note that follows speed, for instance.

fn suspend(&self)

Releases the output device without discarding loaded clips — call it when the app goes to the background.

fn resume(&self)

Re-acquires the output device after suspend.

fn is_available(&self) -> bool

Whether a real device is behind this handle. The no-op default reports false, so an app can honestly grey out its audio settings.

impl Default for NoopAudioPlayer

fn default() -> NoopAudioPlayer

Returns the “default value” for a type.