devela::_dep::sdl3::hint::names

Constant AUDIO_INCLUDE_MONITORS

pub const AUDIO_INCLUDE_MONITORS: &'static str;
Available on crate feature dep_sdl3 only.
Expand description

A variable that causes SDL to not ignore audio “monitors”.

This is currently only used by the PulseAudio driver.

By default, SDL ignores audio devices that aren’t associated with physical hardware. Changing this hint to “1” will expose anything SDL sees that appears to be an audio source or sink. This will add “devices” to the list that the user probably doesn’t want or need, but it can be useful in scenarios where you want to hook up SDL to some sort of virtual device, etc.

The variable can be set to the following values:

  • “0”: Audio monitor devices will be ignored. (default)
  • “1”: Audio monitor devices will show up in the device list.

This hint should be set before SDL is initialized.

§Availability

This hint is available since SDL 3.2.0.