Класс QAudioDeviceInfo

Класс QAudioDeviceInfo предоставляет интерфейс для запроса аудиоустройств и их функциональности. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Статические открытые члены

Подробное описание

QAudioDeviceInfo позволяет запрашивать аудиоустройства, такие как звуковые карты и USB-гарнитуры, которые в настоящее время доступны в системе. Доступные аудиоустройства зависят от платформы или установленных аудиоплагинов.

QAudioDeviceInfo используется Qt для создания классов, которые взаимодействуют с устройством, таких как QAudioInput и QAudioOutput.

Вы также можете запросить каждое устройство о поддерживаемых форматах. Формат в этом контексте — набор, состоящий из определенного порядка байтов, канала, кодека, частоты, частоты дискретизации и типа выборки. Формат представлен классом QAudioFormat.

Поддерживаемые значения для каждого из этих параметров можно получить с помощью supportedByteOrders(), supportedChannelCounts(), supportedCodecs(), supportedSampleRates(), supportedSampleSizes() и supportedSampleTypes(). Поддерживаемые комбинации зависят от платформы, установленных аудиоплагинов и возможностей аудиоустройства. Если вам нужен конкретный формат, вы можете проверить, поддерживает ли его устройство с помощью isFormatSupported(), или получить поддерживаемый формат, максимально приближенный к указанному, с помощью nearestFormat(). Например:

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

QAudioDeviceInfo info(QAudioDeviceInfo::defaultOutputDevice());

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

Статические функции defaultInputDevice(), defaultOutputDevice() и availableDevices() позволяют получить список всех доступных устройств. Устройства извлекаются в соответствии со значением параметра mode, задаваемого перечислением QAudio::Mode. Возвращаемые QAudioDeviceInfo действительны только для заданного QAudio::Mode.

Например:

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

В этом примере кода мы перебираем все устройства, способные выводить звук, т.е. воспроизводить аудиопоток в поддерживаемом формате. Для каждого найденного устройства мы просто выводим deviceName().

См. также QAudioOutput и QAudioInput.

Документация по функциям-членам

QAudioDeviceInfo::QAudioDeviceInfo(const QAudioDeviceInfo &other)

Создает копию other.

QAudioDeviceInfo::QAudioDeviceInfo()

Создаёт пустой объект QAudioDeviceInfo.

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

Устанавливает объект QAudioDeviceInfo равным other.

QAudioDeviceInfo::~QAudioDeviceInfo()

Удаляет информацию об аудиоустройстве.

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

Возвращает список аудиоустройств, которые поддерживают mode.

[static] QAudioDeviceInfo QAudioDeviceInfo::defaultInputDevice()

Возвращает информацию о стандартном устройстве ввода аудио. Все реализации платформы и аудиоплагинов предоставляют стандартное аудиоустройство для использования.

[static] QAudioDeviceInfo QAudioDeviceInfo::defaultOutputDevice()

Возвращает информацию о стандартном устройстве вывода аудио. Все реализации платформы и аудиоплагинов предоставляют стандартное аудиоустройство для использования.

QString QAudioDeviceInfo::deviceName() const

Возвращает удобочитаемое имя аудиоустройства.

Имена устройств различаются в зависимости от используемой платформы/аудиоплагина.

Они представляют собой уникальную строковую идентификацию аудиоустройства.

например, default, Intel, U0x46d0x9a4

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

Возвращает true, если заданные settings поддерживаются аудиоустройством, описанным данным объектом QAudioDeviceInfo.

bool QAudioDeviceInfo::isNull() const

Возвращает true, если данный объект QAudioDeviceInfo не содержит действительного определения устройства.

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

Возвращает ближайший к заданным settings формат QAudioFormat, поддерживаемый системой.

Эти настройки предоставляются используемой платформой/аудиоплагином.

Они также зависят от используемого режима QAudio::Mode.

QAudioFormat QAudioDeviceInfo::preferredFormat() const

Возвращает настройки по умолчанию для формата аудио для данного устройства.

Эти настройки предоставляются используемой платформой/аудиоплагином.

Они также зависят от используемого режима QAudio::Mode.

Типичная аудиосистема может предоставлять следующее:

• Настройки ввода: 8000 Гц моно 8 бит.
• Настройки вывода: 44100 Гц стерео 16 бит little endian.

QString QAudioDeviceInfo::realm() const

Возвращает ключ, представляющий аудиоплагин.

Эта функция была добавлена в Qt 5.14.

См. также QAudioSystemPlugin.

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

Возвращает список поддерживаемых порядков байтов.

QList<int> QAudioDeviceInfo::supportedChannelCounts() const

Возвращает список поддерживаемых количества каналов.

Обычно это 1 для моно звука или 2 для стерео звука.

QStringList QAudioDeviceInfo::supportedCodecs() const

Возвращает список поддерживаемых кодеков.

Все реализации платформы и плагинов должны поддерживать:

"audio/pcm" - Линейный PCM

Для написания плагинов, поддерживающих дополнительные кодеки, см.:

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

QList<int> QAudioDeviceInfo::supportedSampleRates() const

Возвращает список поддерживаемых частот дискретизации (в Герцах).

QList<int> QAudioDeviceInfo::supportedSampleSizes() const

Возвращает список поддерживаемых размеров выборки (в битах).

Обычно это включает размеры выборки 8 и 16 бит.

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

Возвращает список поддерживаемых типов выборки.

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

Возвращает true, если этот класс QAudioDeviceInfo представляет собой другое аудиоустройство, чем other.

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

Возвращает true, если этот класс QAudioDeviceInfo представляет то же самое аудиоустройство, что и other.