Класс QMediaPlayerControl

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

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

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

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

Сигналы

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

Статические открытые члены

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

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

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

Макросы

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

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от 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. Стрoка 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)

Устанавливает состояние звука, выключен ли он.

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