Класс QAudioSystemPlugin

Класс QAudioSystemPlugin предоставляет абстрактную базу для аудио-плагинов. Подробнее...

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

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

Переопределённые открытые функции

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

Написание аудио-плагина достигается путём наследования от этого базового класса, переопределением чистых виртуальных функций availableDevices(), createInput(), createOutput() и createDeviceInfo() и последующим экспортом класса с помощью макроса Q_PLUGIN_METADATA().

Файл json, содержащий метаданные, должен содержать список ключей, соответствующих плагину. Добавьте «default» в ваш список ключей, чтобы переопределить по умолчанию устройство аудио, предоставляемое вашим плагином.

{ "Keys": [ "default" ] }

Для отладки новых плагинов доступны модульные тесты.

Qt поставляется с плагинами для Windows (WinMM и WASAPI), Linux (ALSA и PulseAudio), macOS/iOS (CoreAudio), Android (OpenSL ES) и QNX.

Если доступны аудио-плагины, будет использоваться резервный, подставной бэкенд. Это должно выводить предупреждения в случае попытки использования QAudioInput или QAudioOutput. Для решения этой проблемы убедитесь, что зависимости для Qt-плагинов установлены в системе, переконфигурируйте Qt (например, пакет alsa-devel на Linux) или создайте собственный плагин с ключом по умолчанию, чтобы всегда переопределять резервный подставной бэкенд. Самый простой способ определить, что у вас есть только подставной бэкенд, — получить список доступных аудио-устройств.

QAudioDeviceInfo::availableDevices(QAudio::AudioOutput).size() = 0 (подставной бэкенд)

См. также QAbstractAudioDeviceInfo, QAbstractAudioOutput и QAbstractAudioInput.

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

QAudioSystemPlugin::QAudioSystemPlugin(QObject *parent = nullptr)

Конструирует новый аудио-плагин с parent. Это вызывается автоматически макросом Q_PLUGIN_METADATA().

[virtual] QAudioSystemPlugin::~QAudioSystemPlugin()

Удаляет аудио-плагин. Вам никогда не нужно вызывать это явно. Qt удаляет плагин автоматически, когда он больше не используется.

[override pure virtual] QList<QByteArray> QAudioSystemPlugin::availableDevices(QAudio::Mode mode) const

Возвращает список доступных аудио-устройств для mode

[override pure virtual] QAbstractAudioDeviceInfo *QAudioSystemPlugin::createDeviceInfo(const QByteArray &device, QAudio::Mode mode)

Возвращает указатель на QAbstractAudioDeviceInfo, созданный с использованием device и mode

[override pure virtual] QAbstractAudioInput *QAudioSystemPlugin::createInput(const QByteArray &device)

Возвращает указатель на QAbstractAudioInput, созданный с использованием идентификатора device

[override pure virtual] QAbstractAudioOutput *QAudioSystemPlugin::createOutput(const QByteArray &device)

Возвращает указатель на QAbstractAudioOutput, созданный с использованием идентификатора device