Класс QMediaPlayerControl

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

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

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

• 31 открытая функция, унаследованная от QObject

Сигналы

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

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

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

Макросы

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

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

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

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

Если QMediaService может воспроизводить медиа, он реализует QMediaPlayerControl. Этот контрол позволяет установить медиа для воспроизведения, начать (play), приостановить (pause) и остановить (stop) воспроизведение, перемотать (seek) и управлять громкостью. Он также предоставляет информацию о длительности (duration) медиа, текущей позиции (position) и прогрессе буферизации (buffering).

Функциональность этого контрола доступна коду приложения через класс 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)

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

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

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

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

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

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

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

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

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

[signal] void QMediaPlayerControl::durationChanged(qint64 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)

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

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

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

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

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

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

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

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

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

[signal] void QMediaPlayerControl::mutedChanged(bool 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().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[pure virtual] void QMediaPlayerControl::stop()

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

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

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

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

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

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

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

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

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

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

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