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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Установка медиа в нулевое значение 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)

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

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

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

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

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

[pure virtual] void QMediaPlayerControl::stop()

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

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

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

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

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