Класс QAudioDecoder

Класс QAudioDecoder позволяет декодировать аудио. Подробнее...

Этот класс находится в стадии разработки и может быть изменён.

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

Типы

Свойства

• bufferAvailable : const bool
• error : const QString
• имяИсходногоФайла : QString
• состояние : const State

• 1 свойство унаследовано от QMediaObject
• 1 свойство унаследовано от QObject

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

• 10 открытых функций унаследовано от QMediaObject
• 31 открытых функций унаследовано от QObject

Открытые слоты

• 1 открытый слот унаследован от QObject

Сигналы

• 6 сигналов унаследовано от QMediaObject
• 2 сигнала унаследовано от QObject

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

• 11 статических открытых членов унаследовано от QObject

Дополнительные унаследованные члены

• 2 защищённые функции унаследовано от QMediaObject
• 9 защищённых функций унаследовано от QObject

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

Класс QAudioDecoder позволяет декодировать аудио.

Класс QAudioDecoder — это класс высокого уровня для декодирования локальных аудиомедиафайлов. Он похож на класс QMediaPlayer, за исключением того, что аудио предоставляется обратно через этот API, а не напрямую маршрутизируется на аудиооборудование, и не поддерживаются плейлисты и сетевое/потоковое воспроизведение.

См. также QAudioBuffer.

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

перечисление QAudioDecoder::Ошибка

Определяет состояние ошибки медиаплеера.

перечисление QAudioDecoder::Состояние

Определяет текущее состояние медиаплеера.

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

QAudioDecoder::QAudioDecoder(QObject *parent = Q_NULLPTR)

Создаёт экземпляр QAudioDecoder, родительским объектом которого является parent.

QAudioDecoder::~QAudioDecoder()

Уничтожает объект аудио-декодера.

QAudioFormat QAudioDecoder::audioFormat() const

Возвращает текущий аудио-формат декодируемого потока.

Любые возвращаемые буферы должны иметь этот формат.

См. также setAudioFormat() и formatChanged().

bool QAudioDecoder::bufferAvailable() const

Возвращает true, если буфер доступен для чтения, и false в противном случае. Если буфер недоступен, вызов функции read() вернёт некорректный буфер.

Примечание: Функция-геттер для свойства bufferAvailable.

void QAudioDecoder::bufferAvailableChanged(bool available)

Сигнализирует о доступности нового буфера (если available истинно).

Если available ложно, буферы недоступны.

Примечание: Сигнал уведомления для свойства bufferAvailable.

См. также bufferAvailable() и bufferReady().

void QAudioDecoder::bufferReady()

Сигнализирует о доступности нового декодированного аудио-буфера для чтения.

См. также read() и bufferAvailable().

qint64 QAudioDecoder::duration() const

Возвращает общую продолжительность (в миллисекундах) аудио-потока или -1, если она недоступна.

void QAudioDecoder::durationChanged(qint64 duration)

Сигнализирует о том, что оценочная продолжительность декодированных данных изменилась.

См. также positionChanged().

Error QAudioDecoder::error() const

Возвращает текущее состояние ошибки.

void QAudioDecoder::error(QAudioDecoder::Error error)

Сигнализирует о возникновении состояния ошибки.

Примечание: Сигнал error перегружен в этом классе. Чтобы подключиться к нему с помощью синтаксиса указателя на функцию, необходимо указать тип сигнала в статическом преобразовании, как показано в этом примере:

См. также errorString().

void QAudioDecoder::finished()

Сигнализирует о том, что декодирование завершилось успешно. Если декодирование завершается ошибкой, вместо этого испускается сигнал об ошибке.

См. также start(), stop() и error().

void QAudioDecoder::formatChanged(const QAudioFormat &format)

Сигнализирует о том, что текущий аудио-формат декодера изменился на format.

См. также audioFormat() и setAudioFormat().

QMultimedia::SupportEstimate QAudioDecoder::hasSupport(const QString &mimeType, const QStringList &codecs = QStringList())

Возвращает уровень поддержки аудио-декодером для mimeType и набора codecs.

qint64 QAudioDecoder::position() const

Возвращает позицию (в миллисекундах) последнего считанного буфера из декодера или -1, если буферы не считывались.

void QAudioDecoder::positionChanged(qint64 position)

Сигнализирует о том, что текущая позиция декодера изменилась.

См. также durationChanged().

QAudioBuffer QAudioDecoder::read() const

Считывает буфер из декодера, если он доступен. Возвращает некорректный буфер, если декодированных буферов нет или при ошибке. В обоих случаях функция не будет блокироваться.

Следует либо реагировать на сигнал bufferReady(), либо проверять функцию bufferAvailable() перед вызовом read(), чтобы убедиться, что вы получаете полезные данные.

void QAudioDecoder::setAudioFormat(const QAudioFormat &format)

Устанавливает желаемый аудио-формат для декодированных образцов в format.

Это свойство может быть установлено только когда декодер остановлен. Установка этого свойства в других случаях будет проигнорирована.

Если декодер не поддерживает этот формат, error() будет установлено в FormatError.

Если вы не укажете формат, будет использован формат декодированного аудио. В противном случае будет применено некоторое преобразование форматов.

Если вы хотите сбросить декодированный формат на формат исходного аудиофайла, вы можете указать некорректный формат.

См. также audioFormat().

void QAudioDecoder::setSourceDevice(QIODevice *device)

Устанавливает текущий аудио-QIODevice в device.

Когда это свойство установлено, любое текущее декодирование останавливается, а все аудио-буферы удаляются.

Вы можете указать либо имя файла источника, либо аудио-QIODevice. Установка одного отменяет другое.

См. также sourceDevice().

void QAudioDecoder::setSourceFilename(const QString &fileName)

Устанавливает текущее имя аудиофайла в fileName.

Когда это свойство установлено, любое текущее декодирование останавливается, а все аудио-буферы удаляются.

Вы можете указать либо имя файла источника, либо аудио-QIODevice. Установка одного отменяет другое.

Примечание: Функция-сеттер для свойства sourceFilename.

См. также sourceFilename().

[signal] void QAudioDecoder::sourceChanged()

Сигнализирует, что текущий источник декодера изменился.

Примечание: Сигнал уведомления для свойства sourceFilename.

См. также sourceFilename() и sourceDevice().

QIODevice *QAudioDecoder::sourceDevice() const

Возвращает текущий источник QIODevice, если он был задан. Если был вызван setSourceFilename(), это будет 0.

См. также setSourceDevice().

QString QAudioDecoder::sourceFilename() const

Возвращает текущее имя файла для декодирования. Если был вызван setSourceDevice, это будет пустая строка.

Примечание: Функция-геттер для свойства sourceFilename.

См. также setSourceFilename().

[slot] void QAudioDecoder::start()

Начинает декодирование аудиоресурса.

По мере декодирования данных, сигнал bufferReady() будет испущен, когда будет декодировано достаточно данных. Вызов read() затем вернет буфер аудио без блокировки.

Если вы вызываете read() до готовности буфера, будет возвращен недопустимый буфер, снова без блокировки.

См. также read().

[signal] void QAudioDecoder::stateChanged(QAudioDecoder::State state)

Сигнализирует изменение состояния объекта декодера на state.

Примечание: Сигнал уведомления для свойства state.

[slot] void QAudioDecoder::stop()

Останавливает декодирование аудио. Вызов start() снова возобновит декодирование с начала.