Enum DeviceSelector 

#[non_exhaustive]
pub enum DeviceSelector {
    Default,
    Index(usize),
    Name(String),
    Id(String),
}

How to select an audio device.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Default

Use the system default device.

Index(usize)

Select by device index.

Name(String)

Select by case-insensitive name substring match.

Id(String)

Select by stable per-host device ID.

The ID is the string produced by cpal::DeviceId’s Display impl (WASAPI endpoint ID on Windows, CoreAudio UID on macOS, ALSA pcm_id on Linux). Matching is exact string equality, not substring.

Obtain an ID from MicrophoneInfo::id / SpeakerInfo::id returned by input_devices / output_devices.

Prefer Id over Self::Name when you need stable device selection across enumerations: display names can shift across OS versions or when other devices are plugged in, but per-host IDs don’t.

Trait Implementations

impl Clone for DeviceSelector

fn clone(&self) -> DeviceSelector

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeviceSelector

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.