Класс QMediaPlayer

Класс QMediaPlayer позволяет воспроизводить медиа-источник. Подробнее...

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

Открытые типы

Свойства

• 1 свойство унаследовано от QMediaObject
• 1 свойство унаследовано от QObject

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

Переопределённые открытые функции

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

Открытые слоты

• 1 public slot унаследованный от QObject

Сигналы

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

Статические публичные члены

• 10 static public members унаследованных от QObject

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

• 1 public переменная унаследованная от QObject
• 2 protected функции унаследованные от QMediaObject
• 9 protected функций унаследованных от QObject
• 2 protected переменных унаследованных от QObject

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

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

Класс QMediaPlayer — это класс высокого уровня для воспроизведения медиа. Он может использоваться для воспроизведения песен, фильмов и интернет-радио. Контент для воспроизведения указывается как объект QMediaContent, который можно рассматривать как основной или канонический URL с прикрепленной дополнительной информацией. При предоставлении QMediaContent воспроизведение может начаться.

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

QVideoWidget может использоваться с QMediaPlayer для отображения видео и QMediaPlaylist для доступа к функциональности списка воспроизведения.

playlist = new QMediaPlaylist;
playlist->addMedia(QUrl("http://example.com/movie1.mp4"));
playlist->addMedia(QUrl("http://example.com/movie2.mp4"));
playlist->addMedia(QUrl("http://example.com/movie3.mp4"));
playlist->setCurrentIndex(1);

player = new QMediaPlayer;
player->setPlaylist(playlist);

videoWidget = new QVideoWidget;
player->setVideoOutput(videoWidget);
videoWidget->show();

player->play();

Поскольку QMediaPlayer является QMediaObject, вы можете использовать несколько функций QMediaObject для следующих задач:

• Доступ к метаданным текущего воспроизводимого медиа (QMediaObject::metaData() и предопределённые ключи метаданных)
• Проверка доступности службы воспроизведения медиа (QMediaObject::availability())

См. также QMediaObject, QMediaService, QVideoWidget и QMediaPlaylist.

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

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

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

перечисление QMediaPlayer::Flagфлаги QMediaPlayer::Flags

Тип Flags — это псевдоним для QFlags<Flag>. Он хранит логическое ИЛИ сочетание значений Flag.

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

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

enum QMediaPlayer::State

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

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

QMediaPlayer::QMediaPlayer(QObject *parent = nullptr, QMediaPlayer::Flags flags = ...)

Создаёт экземпляр QMediaPlayer в родительском элементе parent со свойствами flags.

[virtual] QMediaPlayer::~QMediaPlayer()

Удаляет объект плеера.

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

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

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

[signal] void QMediaPlayer::audioRoleChanged(QAudio::Role role)

Сигнализирует изменение роли аудио role медиаплеера.

Эта функция была добавлена в Qt 5.6.

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

[override virtual] QMultimedia::AvailabilityStatus QMediaPlayer::availability() const

Переопределено из QMediaObject::availability().

[signal] void QMediaPlayer::bufferStatusChanged(int percentFilled)

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

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

[signal] void QMediaPlayer::currentMediaChanged(const QMediaContent &media)

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

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

См. также currentMedia() и mediaChanged().

QNetworkConfiguration QMediaPlayer::currentNetworkConfiguration() const

Возвращает текущую используемую точку доступа к сети. Если возвращается по умолчанию сконструированная QNetworkConfiguration, эта функция недоступна или ни одна из предоставленных конфигураций не используется.

[signal] void QMediaPlayer::customAudioRoleChanged(const QString &role)

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

Эта функция была добавлена в Qt 5.11.

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

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

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

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

QMediaPlayer::Error QMediaPlayer::error() const

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

[signal] void QMediaPlayer::error(QMediaPlayer::Error error)

Сигнализирует, что произошла ошибка error.

Примечание: Сигнал error перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя функции Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в этом примере:

connect(mediaPlayer, QOverload<QMediaPlayer::Error>::of(&QMediaPlayer::error),
    [=](QMediaPlayer::Error error){ /* ... */ });

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

[static] QMultimedia::SupportEstimate QMediaPlayer::hasSupport(const QString &mimeType, const QStringList &codecs = QStringList(), QMediaPlayer::Flags flags = ...)

Возвращает уровень поддержки медиаплеером для mimeType и набора codecs.

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

[signal] void QMediaPlayer::mediaChanged(const QMediaContent &media)

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

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

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

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

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

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

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

const QIODevice *QMediaPlayer::mediaStream() const

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

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

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

[signal] void QMediaPlayer::mutedChanged(bool muted)

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

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

[signal] void QMediaPlayer::networkConfigurationChanged(const QNetworkConfiguration &configuration)

Сигнализирует, что активная используемая точка доступа к сети была изменена на configuration, и все последующие доступ к сети будут использовать эту configuration.

[slot] void QMediaPlayer::pause()

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

[slot] void QMediaPlayer::play()

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

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

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

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

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

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

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

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

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

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

[slot] void QMediaPlayer::setMedia(const QMediaContent &media, QIODevice *stream = nullptr)

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

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

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

Примечание: Эта функция возвращает немедленно после записи указанного источника медиа. Она не ожидает завершения загрузки медиа и не проверяет ошибки. Слушайте сигналы mediaStatusChanged() и error(), чтобы получать уведомления о загрузке медиа и об ошибках при загрузке.

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

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

[slot] void QMediaPlayer::setNetworkConfigurations(const QList<QNetworkConfiguration> &configurations)

Устанавливает точки доступа к сети для воспроизведения удалённого медиа. configurations содержит, в порядке возрастания приоритета, список конфигураций, которые могут использоваться для доступа к сети.

Это аннулирует выбор предыдущих конфигураций.

void QMediaPlayer::setVideoOutput(QVideoWidget *output)

Присоединить QVideoWidget видео выход к медиаплеерам.

Если медиаплеером уже прикреплен видеовыход, он будет заменён новым.

void QMediaPlayer::setVideoOutput(QGraphicsVideoItem *output)

Присоединить QGraphicsVideoItem видео выход к медиаплеерам.

Если медиаплеером уже прикреплен видеовыход, он будет заменён новым.

void QMediaPlayer::setVideoOutput(QAbstractVideoSurface *surface)

Устанавливает видео поверхность в качестве видеовыхода медиаплеера.

Если видеовыход уже был установлен для медиаплеера, новая поверхность его заменит.

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

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

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

[slot] void QMediaPlayer::stop()

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

QList<QAudio::Role> QMediaPlayer::supportedAudioRoles() const

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

Если установка аудио роли не поддерживается, возвращается пустой список.

Эта функция была добавлена в Qt 5.6.

См. также audioRole.

QStringList QMediaPlayer::supportedCustomAudioRoles() const

Возвращает список поддерживаемых пользовательских аудио ролей. Пустой список может означать, что поддерживаемые пользовательские аудио роли неизвестны. Список может быть неполным.

Эта функция была добавлена в Qt 5.11.

См. также customAudioRole.

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

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

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

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

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

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