Audio devices: Default vs None

Hi,

The documentation for AudioDeviceManager::AudioDeviceSetup::outputDeviceName states:

The name of the audio device used for output.
[…]
An empty string indicates the default device.

However, setting an empty string actually chooses “None” (no output at all) rather than the default output – at least on my CoreAudio system. Same thing for inputDeviceName.

Is this a bug or a documentation error or is there something else that I have missed?

Thanks
Erik

We also have some issue that sounds similar. Which version are you using?

I think this is a mistake in the documentation. After a bit of investigation, I think that empty names are only interpreted as defaults when calling AudioDeviceManager::initialise. In other contexts (get/setAudioDeviceSetup), an empty device name means that the device is closed.

We’re currently only pushing high-priority bugfixes to develop, with the intention of pushing a bugfix release to master in the very near future. I expect that this documentation fix will reach develop shortly after this bugfix release.

1 Like

:+1:

I’ve updated the docs for these functions here:

Thanks!