Класс QMediaPlayer

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

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

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

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

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

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

Создает экземпляр QMediaPlayer, связанный с parent и с флагами flags.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сигнализирует о возникновении условия error.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[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, данные медиа будут считываться из него вместо разрешения источника медиа. В этом случае URL должен быть предоставлен для разрешения дополнительной информации о медиа, такой как тип MIME. Поток stream должен быть открытым и доступным для чтения. Для macOS stream также должен быть доступен для поиска.

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

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

Начиная с Qt 5.12.2, схема URL gst-pipeline предоставляет пользовательские конвейеры для бэкенда GStreamer.

player = new QMediaPlayer;
player->setMedia(QUrl("gst-pipeline: videotestsrc ! autovideosink"));
player->play();

Если используется QAbstractVideoSurface в качестве видеовывода, qtvideosink может быть использован как элемент видеоприёмника напрямую в конвейере. После этого поверхность будет получать видеокадры в QAbstractVideoSurface::present().

class Surface : public QAbstractVideoSurface
{
public:
    Surface(QObject *p) : QAbstractVideoSurface(p) { }
    QList<QVideoFrame::PixelFormat> supportedPixelFormats(QAbstractVideoBuffer::HandleType) const override
    {
        // Make sure that the driver supports this pixel format.
        return QList<QVideoFrame::PixelFormat>() << QVideoFrame::Format_YUYV;
    }

    // Video frames are handled here.
    bool present(const QVideoFrame &) override { return true; }
};

player = new QMediaPlayer;
player->setVideoOutput(new Surface(player));
player->setMedia(QUrl("gst-pipeline: videotestsrc ! qtvideosink"));
player->play();

Если в качестве видеовывода используется QVideoWidget, а конвейер содержит элемент видеоприёмника с именем qtvideosink, текущий QVideoWidget будет использован для рендеринга видео.

player = new QMediaPlayer;
videoWidget = new QVideoWidget;
videoWidget->show();
player->setVideoOutput(videoWidget);
player->setMedia(QUrl("gst-pipeline: videotestsrc ! xvimagesink name=\"qtvideosink\""));
player->play();

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

QImage img("images/qt-logo.png");
img = img.convertToFormat(QImage::Format_ARGB32);
QByteArray ba(reinterpret_cast<const char *>(img.bits()), img.sizeInBytes());
QBuffer buffer(&ba);
buffer.open(QIODevice::ReadOnly);
player = new QMediaPlayer;
player->setMedia(QUrl("gst-pipeline: appsrc blocksize=4294967295 ! \
    video/x-raw,format=BGRx,framerate=30/1,width=200,height=147 ! \
    coloreffects preset=heat ! videoconvert ! video/x-raw,format=I420 ! jpegenc ! rtpjpegpay ! \
    udpsink host=127.0.0.1 port=5000"), &buffer);
player->play();

QMediaPlayer *receiver = new QMediaPlayer;
videoWidget = new QVideoWidget;
receiver->setVideoOutput(videoWidget);
receiver->setMedia(QUrl("gst-pipeline: udpsrc port=5000 ! \
    application/x-rtp,encoding-name=JPEG,payload=26 ! rtpjpegdepay ! jpegdec ! \
    xvimagesink name=qtvideosink"));
receiver->play();
// Content will be shown in this widget.
videoWidget->show();

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

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

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

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

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

[slot] void QMediaPlayer::stop()

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

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

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

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

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

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

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

[virtual] QMediaPlayer::~QMediaPlayer()

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

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

Переопределяет: QMediaObject::availability() const.

QMediaPlayer::Error QMediaPlayer::error() const

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

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

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

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

const QIODevice *QMediaPlayer::mediaStream() const

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

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

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

void QMediaPlayer::setVideoOutput(QVideoWidget *output)

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

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

void QMediaPlayer::setVideoOutput(QGraphicsVideoItem *output)

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

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

void QMediaPlayer::setVideoOutput(QAbstractVideoSurface *surface)

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

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

void QMediaPlayer::setVideoOutput(const QVector<QAbstractVideoSurface *> &surfaces)

Устанавливает несколько видеоповерхностей в качестве видеовыхода медиаплеера. Это позволяет медиаплеера отображать видеокадры на разных поверхностях.

Все видеоповерхности должны поддерживать по крайней мере одну общую QVideoFrame::PixelFormat.

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

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

См. также QAbstractVideoSurface::supportedPixelFormats.

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

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

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

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

См. также audioRole.

QStringList QMediaPlayer::supportedCustomAudioRoles() const

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

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

См. также customAudioRole.