Класс QMediaPlayer

Класс QMediaPlayer позволяет воспроизводить медиафайлы. Подробнее...

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

Общедоступные типы

Свойства

Общедоступные функции

Общедоступные слоты

Сигналы

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

Класс QMediaPlayer — это класс для воспроизведения медиа высокого уровня. Он может использоваться для воспроизведения аудио и видео файлов. Контент для воспроизведения задаётся объектом QUrl.

player = new QMediaPlayer;
audioOutput = new QAudioOutput;
player->setAudioOutput(audioOutput);
connect(player, SIGNAL(positionChanged(qint64)), this, SLOT(positionChanged(qint64)));
player->setSource(QUrl::fromLocalFile("/Users/me/Music/coolsong.mp3"));
audioOutput->setVolume(50);
player->play();

QVideoWidget может использоваться с QMediaPlayer для отрисовки видео.

См. такжеQVideoWidget.

Документация по типам членов

перечисление QMediaPlayer::Error

Определяет состояние ошибки медиаплеера.

перечисление QMediaPlayer::Loops

Некоторые предопределённые константы для свойства loops.

перечисление QMediaPlayer::MediaStatus

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

перечисление QMediaPlayer::PlaybackState

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

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

QMediaPlayer::QMediaPlayer(QObject *parent = nullptr)

Создаёт экземпляр QMediaPlayer в качестве дочернего объекта parent.

[signal] void QMediaPlayer::bufferProgressChanged(float filled)

Сигнализирует объем заполненного локального буфера filled в виде числа от 0 до 1.

Примечание: Сигнал уведомления для свойства bufferProgress.

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

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

Примечание: Сигнал уведомления для свойства duration.

[signal] void QMediaPlayer::errorOccurred(QMediaPlayer::Error error, const QString &errorString)

Сигнализирует, что произошла ошибка error, при этом errorString содержит описание ошибки.

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

[signal] void QMediaPlayer::hasAudioChanged(bool available)

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

Примечание: Сигнал уведомления для свойства hasAudio.

[signal] void QMediaPlayer::hasVideoChanged(bool videoAvailable)

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

Примечание: Сигнал уведомления для свойства hasVideo.

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

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

Примечание: Сигнал уведомления для свойства mediaStatus.

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

[slot] void QMediaPlayer::pause()

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

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

[slot] void QMediaPlayer::play()

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

См. также pause() и stop().

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

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

Примечание: Сигнал уведомления для свойства playbackRate.

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

Сигнализирует, что позиция контента изменилась на position, выраженную в миллисекундах.

Примечание: Сигнал уведомления для свойства position.

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

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

Примечание: Сигнал уведомления для свойства seekable.

[slot] void QMediaPlayer::setSource(const QUrl &source)

Устанавливает текущий источник.

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

Примечание: Функция-сеттер для свойства source.

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

[slot] void QMediaPlayer::setSourceDevice(QIODevice *device, const QUrl &sourceUrl = QUrl())

Устанавливает текущий источник device.

Данные медиа будут считываться из device. sourceUrl может быть предоставлена для разрешения дополнительной информации о медиа, типе MIME и т. д. device должен быть открытым и доступным для чтения.

Для macOS device также должен поддерживать поиск.

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

[signal] void QMediaPlayer::sourceChanged(const QUrl &media)

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

Примечание: Сигнал-уведомление для свойства source.

[slot] void QMediaPlayer::stop()

Останавливает воспроизведение и сбрасывает позицию воспроизведения к началу.

См. также play() и pause().

[virtual] QMediaPlayer::~QMediaPlayer()

Уничтожает объект плеера.

QList<QMediaMetaData> QMediaPlayer::audioTracks() const

Перечисляет набор доступных аудиодорожек внутри медиа.

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

Разные аудиодорожки могут, например, содержать аудио на разных языках.

Примечание: Функция-геттер для свойства audioTracks.

float QMediaPlayer::bufferProgress() const

Возвращает число от 0 до 1 при буферизации данных.

0 означает, что буферизированных данных нет, воспроизведение обычно приостановлено в этом случае. Возобновление воспроизведения произойдёт, когда буфер достигнет 1, что означает, что достаточно данных было буферизовано для возобновления воспроизведения.

bufferProgress() всегда возвращает 1 для локальных файлов.

Примечание: Функция-геттер для свойства bufferProgress.

QMediaTimeRange QMediaPlayer::bufferedTimeRange() const

Возвращает QMediaTimeRange, описывающий текущие буферизированные данные.

При потоковой передаче медиа из удалённого источника разные части файла медиа могут быть доступны локально. Возвращаемый объект QMediaTimeRange описывает диапазоны времени, которые буферизованы и доступны для немедленного воспроизведения.

См. также QMediaTimeRange.

qint64 QMediaPlayer::duration() const

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

Возвращает 0, если у медиаплеера нет допустимого файла или потока медиа. Для потоковых трансляций продолжительность обычно изменяется во время воспроизведения, поскольку становится доступно больше данных.

Примечание: Функция-геттер для свойства duration.

QMediaPlayer::Error QMediaPlayer::error() const

Возвращает текущее состояние ошибки.

Примечание: Функция-геттер для свойства error.

bool QMediaPlayer::isAvailable() const

Возвращает true, если медиаплейер поддерживается на этой платформе.

bool QMediaPlayer::isSeekable() const

Возвращает true, если медиа доступно для поиска. Большинство файлов медиа доступны для поиска, но потоковые трансляции, как правило, нет.

Примечание: Функция-геттер для свойства seekable.

См. также position.

QMediaMetaData QMediaPlayer::metaData() const

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

Метаданные могут содержать информацию, такую как заголовок видео или его дату создания.

Примечание: Функция-геттер для свойства metaData.

qreal QMediaPlayer::playbackRate() const

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

Примечание: Функция-геттер для свойства playbackRate.

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

qint64 QMediaPlayer::position() const

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

Возвращает 0, если у медиаплеера нет допустимого файла или потока медиа. Для потоковых трансляций продолжительность обычно изменяется во время воспроизведения, поскольку становится доступно больше данных.

Примечание: Функция-геттер для свойства position.

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

const QIODevice *QMediaPlayer::sourceDevice() const

Возвращает источник потока данных медиа.

Это справедливо только в случае, если поток был передан в setSource().

См. также setSourceDevice() и setSource().

QList<QMediaMetaData> QMediaPlayer::subtitleTracks() const

Перечисляет набор доступных субтитров внутри медиа.

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

Примечание: Функция-геттер для свойства subtitleTracks.

QList<QMediaMetaData> QMediaPlayer::videoTracks() const

Перечисляет набор доступных видеодорожек внутри медиа.

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

Примечание: Функция-геттер для свойства videoTracks.