QAudioFormat format;
format.setSampleRate(44100);
// ... other format parameters
format.setSampleType(QAudioFormat::SignedInt);

QAudioDeviceInfo info(QAudioDeviceInfo::defaultOutputDevice());

if (!info.isFormatSupported(format))
    format = info.nearestFormat(format);

const auto deviceInfos = QAudioDeviceInfo::availableDevices(QAudio::AudioOutput);
for (const QAudioDeviceInfo &deviceInfo : deviceInfos)
    qDebug() << "Device name: " << deviceInfo.deviceName();

Member Function Documentation

QAudioDeviceInfo::QAudioDeviceInfo(const QAudioDeviceInfo &other)

Constructs a copy of other.

QAudioDeviceInfo::QAudioDeviceInfo()

Constructs an empty QAudioDeviceInfo object.

QAudioDeviceInfo &QAudioDeviceInfo::operator=(const QAudioDeviceInfo &other)

Sets the QAudioDeviceInfo object to be equal to other.

QAudioDeviceInfo::~QAudioDeviceInfo()

Destroy this audio device info.

[static] QList<QAudioDeviceInfo> QAudioDeviceInfo::availableDevices(QAudio::Mode mode)

Returns a list of audio devices that support mode.

[static] QAudioDeviceInfo QAudioDeviceInfo::defaultInputDevice()

Returns the information for the default input audio device. All platform and audio plugin implementations provide a default audio device to use.

[static] QAudioDeviceInfo QAudioDeviceInfo::defaultOutputDevice()

Returns the information for the default output audio device. All platform and audio plugin implementations provide a default audio device to use.

QString QAudioDeviceInfo::deviceName() const

Returns the human readable name of the audio device.

Device names vary depending on the platform/audio plugin being used.

They are a unique string identifier for the audio device.

eg. default, Intel, U0x46d0x9a4

bool QAudioDeviceInfo::isFormatSupported(const QAudioFormat &settings) const

Returns true if the supplied settings are supported by the audio device described by this QAudioDeviceInfo.

bool QAudioDeviceInfo::isNull() const

Returns whether this QAudioDeviceInfo object holds a valid device definition.

QAudioFormat QAudioDeviceInfo::nearestFormat(const QAudioFormat &settings) const

Returns the closest QAudioFormat to the supplied settings that the system supports.

These settings are provided by the platform/audio plugin being used.

They are also dependent on the QAudio::Mode being used.

QAudioFormat QAudioDeviceInfo::preferredFormat() const

Returns the default audio format settings for this device.

These settings are provided by the platform/audio plugin being used.

They are also dependent on the QAudio::Mode being used.

A typical audio system would provide something like:

• Input settings: 8000Hz mono 8 bit.
• Output settings: 44100Hz stereo 16 bit little endian.

QString QAudioDeviceInfo::realm() const

Returns the key that represents the audio plugin.

This function was introduced in Qt 5.14.

See also QAudioSystemPlugin.

QList<QAudioFormat::Endian> QAudioDeviceInfo::supportedByteOrders() const

Returns a list of supported byte orders.

QList<int> QAudioDeviceInfo::supportedChannelCounts() const

Returns a list of supported channel counts.

This is typically 1 for mono sound, or 2 for stereo sound.

QStringList QAudioDeviceInfo::supportedCodecs() const

Returns a list of supported codecs.

All platform and plugin implementations should provide support for:

"audio/pcm" - Linear PCM

For writing plugins to support additional codecs refer to:

http://www.iana.org/assignments/media-types/audio/

QList<int> QAudioDeviceInfo::supportedSampleRates() const

Returns a list of supported sample rates (in Hertz).

QList<int> QAudioDeviceInfo::supportedSampleSizes() const

Returns a list of supported sample sizes (in bits).

Typically this will include 8 and 16 bit sample sizes.

QList<QAudioFormat::SampleType> QAudioDeviceInfo::supportedSampleTypes() const

Returns a list of supported sample types.

bool QAudioDeviceInfo::operator!=(const QAudioDeviceInfo &other) const

Returns true if this QAudioDeviceInfo class represents a different audio device than other

bool QAudioDeviceInfo::operator==(const QAudioDeviceInfo &other) const

Returns true if this QAudioDeviceInfo class represents the same audio device as other.