Класс QMediaPlayerControl

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

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

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

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

Сигналы

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

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

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

Макросы

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

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 1 открытая переменная, унаследованная от QObject
• 10 статических открытых членов, унаследованных от QObject
• 2 защищенных переменных, унаследованных от QObject

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

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

[virtual] QMediaPlayerControl::~QMediaPlayerControl()

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

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

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

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

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

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

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

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

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

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

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

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

Сигнализирует о возникновении ошибки error. 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)

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

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

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

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

[pure virtual] void QMediaPlayerControl::stop()

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

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

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

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

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

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

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

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

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

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

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