Класс QAudioDecoderControl

Класс QAudioDecoderControl предоставляет доступ к функциональности декодирования аудио от QMediaService. Подробнее...

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

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

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

Сигналы

Защищённые функции

Макросы

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

Функциональность этого управления доступна коду приложения через класс QAudioDecoder.

Имя интерфейса QAudioDecoderControl равно org.qt-project.qt.audiodecodercontrol/5.0 как определено в QAudioDecoderControl_iid.

См. также QMediaService::requestControl() и QAudioDecoder.

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

[protected] QAudioDecoderControl::QAudioDecoderControl(QObject *parent = nullptr)

Создаёт новый объект управления декодированием аудио с заданным parent.

[signal] void QAudioDecoderControl::bufferAvailableChanged(bool available)

Сигнализирует о том, что свойство bufferAvailable изменилось на available.

[signal] void QAudioDecoderControl::bufferReady()

Сигнализирует о том, что новый буфер готов для чтения.

[signal] void QAudioDecoderControl::durationChanged(qint64 duration)

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

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

[signal] void QAudioDecoderControl::error(int error, const QString &errorString)

Сигнализирует о возникновении error. Свойство errorString содержит более подробное описание.

[signal] void QAudioDecoderControl::finished()

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

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

[signal] void QAudioDecoderControl::formatChanged(const QAudioFormat &format)

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

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

[signal] void QAudioDecoderControl::positionChanged(qint64 position)

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

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

[signal] void QAudioDecoderControl::sourceChanged()

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

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

[signal] void QAudioDecoderControl::stateChanged(QAudioDecoder::State newState)

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

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

[virtual] QAudioDecoderControl::~QAudioDecoderControl()

Удаляет объект управления декодированием аудио.

[pure virtual] QAudioFormat QAudioDecoderControl::audioFormat() const

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

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

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

[pure virtual] bool QAudioDecoderControl::bufferAvailable() const

Возвращает true, если буфер доступен для чтения, и false в противном случае.

[pure virtual] qint64 QAudioDecoderControl::duration() const

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

[pure virtual] qint64 QAudioDecoderControl::position() const

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

[pure virtual] QAudioBuffer QAudioDecoderControl::read()

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

[pure virtual] void QAudioDecoderControl::setAudioFormat(const QAudioFormat &format)

Устанавливает желаемый формат аудио для декодированных сэмплов в format.

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

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

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

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

[pure virtual] void QAudioDecoderControl::setSourceDevice(QIODevice *device)

Устанавливает текущий источник в device. Изменение источника остановит текущее декодирование и удалит все буферы.

Источники являются исключительными, поэтому может быть установлен только один.

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

[pure virtual] void QAudioDecoderControl::setSourceFilename(const QString &fileName)

Устанавливает текущий источник в fileName. Изменение источника остановит текущее декодирование и удалит все буферы.

Источники являются исключительными, поэтому может быть установлен только один.

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

[pure virtual] QIODevice *QAudioDecoderControl::sourceDevice() const

Возвращает текущий источник медиа QIODevice, или 0, если нет (или файл).

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

[pure virtual] QString QAudioDecoderControl::sourceFilename() const

Возвращает текущее имя файла источника медиа, или пустой QString, если нет (или устройство).

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

[pure virtual] void QAudioDecoderControl::start()

Начинает декодирование текущей медиа.

При успешном выполнении контроллер плеера сразу перейдет в состояние декодирования.

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

[pure virtual] QAudioDecoder::State QAudioDecoderControl::state() const

Возвращает состояние контроллера плеера.

[pure virtual] void QAudioDecoderControl::stop()

Останавливает воспроизведение текущей медиа и удаляет все буферы.

При успешном выполнении контроллер плеера сразу перейдет в состояние остановки.