Класс QMediaPlayerControl

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

Этот класс устарел. Он предоставляется для поддержки старого кода. Мы настоятельно рекомендуем не использовать его в новом коде.

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

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

Сигналы

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

Макросы

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

Если QMediaService может воспроизводить медиа, он реализует QMediaPlayerControl. Этот контроллер предоставляет средства для установки воспроизводимого медиа, запуска, паузы и остановки воспроизведения, позиционирования и управления громкостью. Он также предоставляет обратную связь по длительности медиа, текущей позиции и прогрессу буферизации.

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

Имя интерфейса QMediaPlayerControl равно org.qt-project.qt.mediaplayercontrol/5.0 , как определено в QMediaPlayerControl_iid.

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

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

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

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

[signal] void QMediaPlayerControl::audioAvailableChanged(bool audioAvailable)

Сигнализирует о изменении доступности аудиовывода audioAvailable.

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

[signal] void QMediaPlayerControl::availablePlaybackRangesChanged(const QMediaTimeRange &ranges)

Сигнализирует о изменении доступных диапазонов воспроизведения медиа ranges.

См. также QMediaPlayerControl::availablePlaybackRanges().

[signal] void QMediaPlayerControl::bufferStatusChanged(int percentFilled)

Сигнализирует о процентном заполнении локального буфера, равном percentFilled.

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

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

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

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

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

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

[signal] void QMediaPlayerControl::mediaChanged(const QMediaContent &content)

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

[signal] void QMediaPlayerControl::mediaStatusChanged(QMediaPlayer::MediaStatus status)

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

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

[signal] void QMediaPlayerControl::mutedChanged(bool mute)

Сигнализирует о изменении состояния mute управления воспроизведением.

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

[signal] void QMediaPlayerControl::playbackRateChanged(qreal rate)

Вызывается при изменении скорости воспроизведения на rate.

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

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

Вызывается только при не непрерывном изменении позиции воспроизведения, таком как поиск или сброс позиции.

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

[signal] void QMediaPlayerControl::seekableChanged(bool seekable)

Сигнализирует о изменении состояния возможности поиска в управлении воспроизведением на seekable.

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

[signal] void QMediaPlayerControl::stateChanged(QMediaPlayer::State newState)

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

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

[signal] void QMediaPlayerControl::videoAvailableChanged(bool videoAvailable)

Сигнал, что доступность визуального контента изменилась на videoAvailable.

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

[signal] void QMediaPlayerControl::volumeChanged(int volume)

Сигнализирует о изменении громкости управления воспроизведением на volume.

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

[virtual] QMediaPlayerControl::~QMediaPlayerControl()

Уничтожает управление медиаплеером.

[pure virtual] QMediaTimeRange QMediaPlayerControl::availablePlaybackRanges() const

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

Обычно для локальных файлов это непрерывный интервал, равный [0..duration()] или пустой диапазон, если поиск не поддерживается, но для сетевых источников он относится к буферизованным частям медиа.

[pure virtual] int QMediaPlayerControl::bufferStatus() const

Возвращает процент заполнения буфера текущего медиа.

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

Возвращает длительность текущего медиа в миллисекундах.

[pure virtual] bool QMediaPlayerControl::isAudioAvailable() const

Определяет, доступен ли аудиовыход для текущего медиа.

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

[pure virtual] bool QMediaPlayerControl::isMuted() const

Возвращает состояние отключения звука управления воспроизведением.

[pure virtual] bool QMediaPlayerControl::isSeekable() const

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

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

[pure virtual] bool QMediaPlayerControl::isVideoAvailable() const

Определяет, доступен ли видеовыход для текущего медиа.

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

[pure virtual] QMediaContent QMediaPlayerControl::media() const

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

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

[pure virtual] QMediaPlayer::MediaStatus QMediaPlayerControl::mediaStatus() const

Возвращает состояние текущего медиа.

[pure virtual] const QIODevice *QMediaPlayerControl::mediaStream() const

Возвращает текущий поток медиа. Это значение является допустимым только в том случае, если поток был передан в setMedia().

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

[pure virtual] void QMediaPlayerControl::pause()

Приостанавливает воспроизведение текущего медиа.

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

См. также state(), play() и stop().

[pure virtual] void QMediaPlayerControl::play()

Запускает воспроизведение текущего медиа.

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

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

[pure virtual] qreal QMediaPlayerControl::playbackRate() const

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

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

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

Возвращает текущую позицию воспроизведения в миллисекундах.

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

[pure virtual] void QMediaPlayerControl::setMedia(const QMediaContent &media, QIODevice *stream)

Устанавливает текущий источник media. Если указан stream, данные будут читаться из него вместо попытки разрешения источника медиа. Источник медиа всё ещё может быть использован для предоставления информации о медиа, такой как тип MIME.

Установление медиа в значение null QMediaContent приведёт к удалению всей информации, относящейся к текущему источнику медиа, и прекращению всех операций ввода-вывода, связанных с этим медиа.

Файлы ресурсов Qt никогда не передаются как есть. Если служба поддерживает QMediaServiceProviderHint::StreamPlayback, то stream указывает на открытый QFile. В противном случае ресурс копируется во временный файл, а media содержит URL этого файла.

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

[pure virtual] void QMediaPlayerControl::setMuted(bool mute)

Устанавливает состояние отключения звука управления воспроизведением на mute.

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

[pure virtual] void QMediaPlayerControl::setPlaybackRate(qreal rate)

Устанавливает скорость воспроизведения на rate.

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

[pure virtual] void QMediaPlayerControl::setPosition(qint64 position)

Устанавливает позицию воспроизведения текущего медиа на position. Это инициирует поиск, и может потребоваться некоторое время для достижения заданной позиции воспроизведения.

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

[pure virtual] void QMediaPlayerControl::setVolume(int volume)

Устанавливает громкость аудио volume элемента управления воспроизведением.

Громкость масштабируется линейно, от 0 (тишина) до 100 (полная громкость).

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

[pure virtual] QMediaPlayer::State QMediaPlayerControl::state() const

Возвращает состояние элемента управления воспроизведением.

[pure virtual] void QMediaPlayerControl::stop()

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

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

[pure virtual] int QMediaPlayerControl::volume() const

Возвращает громкость аудио элемента управления воспроизведением.

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