Класс 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