Класс QMediaPlayerControl

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

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

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

• 32 открытых функции унаследованы от QObject

Сигналы

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

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

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

Макросы

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

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

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

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

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

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

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

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

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

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

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

QMediaPlayerControl::~QMediaPlayerControl()

Удаляет контроллер медиаплеера.

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

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

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

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

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

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

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

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

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

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

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

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

Сигнализирует об изменении прогресса буферизации progress.

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

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

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

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

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

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

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

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

[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().

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

Сигнализирует об изменении текущего медиа content.

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

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

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

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

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

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

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

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

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

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

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

[pure virtual] void QMediaPlayerControl::pause()

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

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

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

[pure virtual] void QMediaPlayerControl::play()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[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

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

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

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

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

[pure virtual] void QMediaPlayerControl::stop()

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

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

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

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

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

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

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

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

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

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

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