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

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

См. также 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()

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

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