Struct AudioBell 

pub struct AudioBell { /* private fields */ }

Audio bell manager for playing terminal bell sounds.

When the audio feature is enabled this uses rodio for real audio playback. When disabled, all methods are no-ops so callers never need conditional code.

Implementations

impl AudioBell

pub fn new() -> Result<Self, String>

Create a new audio bell manager

pub fn disabled() -> Self

Create a dummy/disabled audio bell (safe fallback)

pub fn play(&self, volume: u8)

Play a bell sound with the specified volume (0-100)

Arguments

• volume - Volume level from 0 to 100. A value of 0 disables the bell sound.

pub fn play_tone(&self, volume: u8, frequency: f32, duration_ms: u64)

Play a tone with configurable frequency and duration

Arguments

• volume - Volume level from 0 to 100. A value of 0 disables the sound.
• frequency - Frequency in Hz (e.g. 800.0 for standard bell)
• duration_ms - Duration in milliseconds

pub fn play_file(&self, volume: u8, path: &Path)

Play a sound file (WAV/MP3/OGG/FLAC) at the specified volume

Arguments

• volume - Volume level from 0 to 100
• path - Path to the sound file

pub fn play_alert(&self, config: &AlertSoundConfig)

Play an alert sound using the given configuration

Trait Implementations

impl Default for AudioBell

Available on crate feature audio only.

fn default() -> Self

A silent bell that owns no output device.

This deliberately does not open a device. shared is the only sanctioned way to obtain a working bell, because opening a second device from another thread faults inside WASAPI on Windows. A Default that quietly opened its own device re-introduced exactly that crash, and had no callers outside tests. Matches the no-audio build’s behaviour.

impl Drop for AudioBell

Available on crate feature audio only.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.