[QT_052]Qt视频播放相关类说明（QMediaPlayer、QMediaPlaylist、QVideoWidget）

已于 2023-05-15 14:14:32 修改
阅读量2k 收藏 15
点赞数 2
分类专栏： # Qt学习记录 文章标签： qt Qt视频播放 音视频
于 2023-04-24 15:56:19 首次发布
原文链接：https://blog.csdn.net/zhaoyun_zzz/article/details/90290552
版权

本文转自：https://blog.csdn.net/zhaoyun_zzz/article/details/90290552

1.QMediaPlayer相关说明

QMediaPlayer类的player播放状态：State

状态枚举名称枚举值说明
StoppedState0播放停止状态
PlayingState1播放状态
PausedState2播放暂停状态

QMediaPlayer类的媒体状态：MediaStatus

状态枚举名称枚举值说明
UnknownMediaStatus0未知状态
NoMedia1无媒体文件，player处于StoppedState
LoadingMedia2媒体文件加载中，player可以处于任何状态
LoadedMedia3媒体文件已加载，player处于StoppedState
StalledMedia4媒体处于延迟或者暂时的中断状态，palyer处于 PlayingState或者PausedState
BufferingMedia5媒体正在缓冲数据，palyer处于 PlayingState或者PausedState
BufferedMedia6媒体缓冲数据完成，palyer处于 PlayingState或者PausedState
EndOfMedia7媒体结束，player处于StoppedState
InvalidMedia8非法的媒体文件，player处于StoppedState

QMediaPlayer类的player播放标志位：Flags

状态枚举名称枚举值说明
LowLatency1播放未压缩的音频数据，播放表现为低延时，主要播放beeps, ringtones等
StreamPlayback2播放基于 QIODevice构建的媒体文件，QMediaPlayer或自动选择支持的流进行播放
VideoSurface4渲染视频到QAbstractVideoSurface output

QMediaPlayer类的player错误标志位：Error

状态枚举名称枚举值说明
NoError0无错误
ResourceError1媒体源错误
FormatError2格式错误，播放可能会丢失音频或者视频
NetworkError3网络错误
AccessDeniedError4访问权限错误
ServiceMissingError5服务丢失错误

QMediaPlayer类的属性：

属性名称取值类型说明访问函数
audioAvailableconst bool音频是否可用，audioAvailableChanged信号函数用于监控其状态bool isAudioAvailable() const
audioRoleQAudio::Role音频流播放roleQAudio::Role audioRole() const，void setAudioRole(QAudio::Role audioRole)
bufferStatusconst int缓冲数据的百分比，在开始播放或者回复播放之前int bufferStatus() const， void bufferStatusChanged(int percentFilled)
currentMediaconst QMediaContent当前激活的媒体，在使用Playlist时，可能与mdia属性不同QMediaContent currentMedia() const， void currentMediaChanged(const QMediaContent &media)
durationconst qint64currentMedia的播放时长，单位msqint64 duration() const， void durationChanged(qint64 duration)
mediaQMediaContent激活的并被使用的媒体源QMediaContent media() const， void setMedia(const QMediaContent &media, QIODevice *stream = nullptr)， void mediaChanged(const QMediaContent &media)
playbackRateqreal当前媒体的播放速度，默认为1.0qreal playbackRate() const， void setPlaybackRate(qreal rate)， void playbackRateChanged(qreal rate)
playlistQMediaPlaylist*播放列表QMediaPlaylist * playlist() const， void setPlaylist(QMediaPlaylist *playlist)，
volumeint音量，取值范围0—100int volume() const， void setVolume(int volume)， void volumeChanged(int volume

播放音频步骤

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

播放视频频步骤

QMediaPlayer要播放视频需要使用辅助类QVideoWidget、QGraphicsVideoItem，将辅助类对象设置为QMediaPlayer的视频输出窗口，就可以播放视频。

playlist = new QMediaPlaylist;
playlist->addMedia(QUrl("movie1.mp4"));
playlist->addMedia(QUrl("movie2.mp4"));
playlist->addMedia(QUrl("movie3.mp4"));
playlist->setCurrentIndex(1);

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

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

player->play();

2.QMediaPlaylist相关说明

QMediaPlaylist类，可以为QMediaPlayer提供一个播放列表，它其实是QMediaContent对象的列表。QMediaPlayer通过函数setPlayList来设置一个播放列表QMediaPlaylist；通过函数addMedia播放列表添加一个媒体文件。QMediaPlaylist类的播放模式：PlaybackMode

状态枚举名称枚举值说明
CurrentItemOnce0当前选中的媒体文件仅播放一次
CurrentItemInLoop1当前选中的媒体文件循环播放
Sequential2从当前选中的媒体文件开始，列表中的文件顺序播放一次直到最后一个文件
Loop3列表中的文件顺序循环播放
Random4列表中的文件随机播放

QMediaPlaylist属性：

名称类型说明
currentIndexint当前播放的媒体文件在列表中的索引
currentMediaconst QMediaContent当前选中的媒体文件
palybackModeQMediaPlaylist::PlaybackMode从当前选中的媒体文件开始，列表中的文件顺序播放一次直到最后一个文件

QMediaPlaylist函数：

返回值类型函数名称描述说明
booladdMedia(const QMediaContent &content)Public Functions，列表添加单个媒体文件
booladdMedia(const QList &items)Public Functions，列表添加多个媒体文件
intcurrentIndex() const获得当前播放媒体的索引
QMediaContentcurrentMedia() const获得当前播放的媒体文件
QMediaPlaylist::Errorerror() const列表错误状态
QStringerrorString() const播放列表错误字符串信息
boolinsertMedia(int pos, const QMediaContent &content)向播放列表插入一个媒体文件
boolinsertMedia(int pos, const QList &items)向播放列表插入多个媒体文件
boolisEmpty() const清空列表
boolisReadOnly() const清空列表
voidload(const QNetworkRequest &request, const char *format = nullptr)加载网络媒体
voidload(const QUrl &location, const char *format = nullptr)加载本地媒体文件
voidload(QIODevice *device, const char *format = nullptr)加载IO设备文件
QMediaContentmedia(int index) const获得指定索引的媒体文件
intmediaCount() const统计播放列表的文件数量
boolmoveMedia(int from, int to)根据位置参数移动媒体文件
intnextIndex(int steps = 1) const当前播放文件的下一个文件索引
PlaybackModeplaybackMode() const获取列表播放模式
intpreviousIndex(int steps = 1) const当前播放文件的上一个文件索引
boolremoveMedia(int pos)删除列表中指定位置的文件
boolremoveMedia(int start, int end)删除列表中start到end之间的文件
boolsave(const QUrl &location, const char *format = nullptr)保存列表QUrl 指定位置
boolsave(QIODevice *device, const char *format)保存列表到IO设备
voidsetPlaybackMode(QMediaPlaylist::PlaybackMode mode)设置列表播放模式

QMediaPlaylist槽：

返回值类型函数名称描述说明
voidnext()下一个文件
voidprevious()上一个文件
voidsetCurrentIndex(int playlistPosition)设置当前播放媒体的索引
voidshuffle()媒体顺序洗牌，重建媒体的索引

QMediaPlaylist信号：

返回值类型函数名称描述说明
voidcurrentIndexChanged(int position)当前索引改变信号
voidcurrentMediaChanged(const QMediaContent &content)当前媒体文件改变信号
voidloadFailed()加载失败信号
voidloaded()加载完成信号
voidmediaAboutToBeInserted(int start, int end)媒体即将被插入信号
voidmediaAboutToBeRemoved(int start, int end)媒体即将被删除信号
voidmediaChanged(int start, int end)媒体文件改变信号
voidmediaInserted(int start, int end)媒体文件插入信号
voidmediaRemoved(int start, int end)媒体文件删除信号
voidplaybackModeChanged(QMediaPlaylist::PlaybackMode mode)列表播放模式改变信号

3.QVideoWidget相关说明

QVideoWidget是一个用来展示视频的类，需要先定义一个QMediaPlayer对象，然后将QMediaPlayer的VideoOutput设置为QVideoWidget对象即可。
QVideoWidget属性：

名称类型说明
aspectRatioMode :Qt::AspectRatioMode屏幕高宽比
brightnessint亮度
contrastint对比度
fullScreenbool是否全屏
hueint色调
mediaObjectQMediaObject* const视频媒体对象
saturationint饱和度

QVideoWidget函数：

返回值类型函数名称描述说明
Qt::AspectRatioModeaspectRatioMode() const获取视频画面宽高比
intsaturation() const获取饱和度
intbrightness() const获取亮度
intcontrast() const获取对比度
inthue() const获取色调
boolisFullScreen() const获取全屏状态

QVideoWidget槽：

返回值类型函数名称描述说明
voidsetAspectRatioMode(Qt::AspectRatioMode mode)设置宽高比
voidsetBrightness(int brightness)设置亮度
voidsetContrast(int contrast)设置对比度
voidsetFullScreen(bool fullScreen)设置全屏状态
voidsetHue(int hue)设置色调
voidsetSaturation(int saturation)设置饱和度

QMediaPlaylist信号：

返回值类型函数名称描述说明
voidbrightnessChanged(int brightness)亮度改变信号
voidcontrastChanged(int contrast)对比度改变信号
voidfullScreenChanged(bool fullScreen)全屏状态信号
voidhueChanged(int hue)色调改变信号
voidsaturationChanged(int saturation)饱和度改变信号

完整示例代码

mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QMediaPlayer>
class QMediaPlaylist;

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();

private slots:
    void on_pushButton_clicked();

    void on_pushButton_2_clicked();

    void on_pushButton_3_clicked();

    void on_horizontalSlider_sliderMoved(int position);

private:
    Ui::MainWindow *ui;
    QMediaPlayer *player;

    QMediaPlaylist *playlist;

private slots:
    void updatePosition(qint64 position);

    void stateChanged(QMediaPlayer::State state);
    void mediaStatusChanged(QMediaPlayer::MediaStatus status);
    void showError(QMediaPlayer::Error error);

    void metaDataAvailableChanged(bool available);
};

#endif // MAINWINDOW_H

mainwindow.cpp

// mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QMediaPlaylist>

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    player = new QMediaPlayer(this);
    connect(player, &QMediaPlayer::positionChanged,
            this, &MainWindow::updatePosition);

    connect(player, &QMediaPlayer::stateChanged, this, &MainWindow::stateChanged);
    connect(player, &QMediaPlayer::mediaStatusChanged,
            this, &MainWindow::mediaStatusChanged);
    connect(player, static_cast<void(QMediaPlayer::*)(QMediaPlayer::Error)>
            (&QMediaPlayer::error), this, &MainWindow::showError);

    connect(player, &QMediaPlayer::metaDataAvailableChanged,
            this, &MainWindow::metaDataAvailableChanged);


    playlist = new QMediaPlaylist;
    playlist->addMedia(QUrl::fromLocalFile("/home/luke/Music/music.mp3"));
    playlist->addMedia(QUrl::fromLocalFile("/home/luke/Music/music2.mp3"));
    playlist->addMedia(QUrl::fromLocalFile("/home/luke/Music/music3.mp3"));
    playlist->setCurrentIndex(0);
    playlist->setPlaybackMode(QMediaPlaylist::Loop);
    player->setPlaylist(playlist);
}


MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::on_pushButton_clicked()
{ // 播放
    player->play();
}

void MainWindow::on_pushButton_2_clicked()
{ // 暂停
    player->pause();
}

void MainWindow::on_pushButton_3_clicked()
{ // 停止
    player->stop();
}


void MainWindow::on_horizontalSlider_sliderMoved(int position)
{ // 设置播放进度
    player->setPosition(position * 1000);
}

void MainWindow::updatePosition(qint64 position)
{ // 更新滑块显示
    ui->horizontalSlider->setMaximum(player->duration() / 1000);
    ui->horizontalSlider->setValue(position / 1000);
}

void MainWindow::mediaStatusChanged(QMediaPlayer::MediaStatus status)
{
    switch (status) {
    case QMediaPlayer::UnknownMediaStatus:
        ui->label->setText(tr("媒体未知状况！"));
        break;
    case QMediaPlayer::NoMedia:
        ui->label->setText(tr("没有媒体文件！"));
        break;
    case QMediaPlayer::BufferingMedia:
        ui->label->setText(tr("正在缓冲媒体文件！"));
        break;
    case QMediaPlayer::BufferedMedia:
        ui->label->setText(tr("媒体文件缓冲完成！"));
        break;
    case QMediaPlayer::LoadingMedia:
        ui->label->setText(tr("正在加载媒体！"));
        break;
    case QMediaPlayer::StalledMedia:
        ui->label->setText(tr("播放停滞！"));
        break;
    case QMediaPlayer::EndOfMedia:
        ui->label->setText(tr("播放结束！"));
        break;
    case QMediaPlayer::LoadedMedia:
        ui->label->setText(tr("媒体加载完成！"));
        break;
    case QMediaPlayer::InvalidMedia:
        ui->label->setText(tr("不可用的媒体文件！"));
        break;
    default: break;
    }
}

void MainWindow::stateChanged(QMediaPlayer::State state)
{
    switch (state) {
    case QMediaPlayer::StoppedState:
        ui->label_2->setText(tr("停止状态！"));
        break;
    case QMediaPlayer::PlayingState:
        ui->label_2->setText(tr("播放状态！"));
        break;
    case QMediaPlayer::PausedState:
        ui->label_2->setText(tr("暂停状态！"));
        break;
    default: break;
    }
}

void MainWindow::showError(QMediaPlayer::Error error)
{
    switch (error) {
    case QMediaPlayer::NoError:
        ui->label_3->setText(tr("没有错误！"));
        break;
    case QMediaPlayer::ResourceError:
        ui->label_3->setText(tr("媒体资源无法被解析！"));
        break;
    case QMediaPlayer::FormatError:
        ui->label_3->setText(tr("不支持该媒体格式！"));
        break;
    case QMediaPlayer::NetworkError:
        ui->label_3->setText(tr("发生了一个网络错误！"));
        break;
    case QMediaPlayer::AccessDeniedError:
        ui->label_3->setText(tr("没有播放权限！"));
        break;
    case QMediaPlayer::ServiceMissingError:
        ui->label_3->setText(tr("没有发现有效的播放服务！"));
        break;
    default: break;
    }
}

// 获取元数据
void MainWindow::metaDataAvailableChanged(bool available)
{
    if(available) {
        QString title = player->metaData("Title").toString();
        QString author = player->metaData("Author").toString();
        setWindowTitle(title + "-" + author);
    }
}

main.cpp

#include "mainwindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    return a.exec();
}
天空之城8020
关注
专栏目录
8.2.1 QMediaPlayer类介绍与基本使用
10-24 2422
8.2 播放音乐与视频 8.2.1 QMediaPlayer类介绍与基本使用 QMediaPlayer类是高级媒体播放类。 它可用于播放歌曲，电影和网络收音机等内容。 要播放的内容被指定为QMediaContent对象，QMediaContent类提供对媒体内容相关的资源访问。 QMediaContent在多媒体框架中用作媒体内容的逻辑句柄。 QMediaContent对象由一个或多个QMediaResources组成，其中每个资源都提供不同内容编码的URL和格式信息。 非空的QMediaCont.
Qt QMediaPlayer 视频播放器
04-24
Qt QMediaPlayer 是一个强大的多媒体框架，它允许开发者在Qt应用程序中轻松地集成音频和视频播放功能。这个组件是Qt Multimedia模块的一部分，提供了丰富的API来控制媒体播放，包括播放、暂停、停止、快进、倒退以及...
QT 播放器之VideoWidget
热门推荐
小鱼游戏开发的博客
09-24 1万+
我们首先需要找到视频播放的类， 不会找不要紧~直接打开翻译 视频->Video ，播放 ->Play 组合起来就是 QVideoPlay或者 QPlayVideo，搜索文档看看，很好！并没有想要的类 那么搜索一下QVideo呢，滚动一下看到一个QVideoWidget，或许这个就是我们想要的？ 打开该文档找一下，找到以下栗子~ OK,这么说 我们需要的就是 QMediaP...
QVideoWidget遇到setAttribute(Qt::WA_TranslucentBackground)问题
最新发布
songjianxinge的博客
07-16 495
Qt下使用setAttribute(Qt::WA_TranslucentBackground)是因为自定义窗口，需要能够有圆角窗口，阴影特殊效果出现，但是如果出现这个窗口使用QVideoWidget基于该窗口指针父类显示视频效果时候，因该属性的设置导致QVideoWidget无法显示的问题出现。QVideoWidget无法使用下，就自定义类去进行视图刷新，能够更加灵活，可以在视图上增加更多的操作。
QMediaPlaylist类
周翔的专栏
04-19 5957
QMediaPlaylist表面上只是一个媒体播放列表一样，保存了很多的媒体的路径，可是远不知这些。                     此类有一个函数，void    setPlaybackMode(PlaybackMode mode)，而                     enum    PlaybackMode { CurrentItemOnce, CurrentItemInL
QMediaPlayer（状态）
qq_45303986的博客
11-27 4561
在音乐播放中介绍了QMudiaPlayer的基本用法，在这里更深度的使用QMudiaPlayer。
QT之QMediaPlayer音视频播放类
路过的熊的博客
08-19 1442
QT之QMediaPlayer音视频播放类
QMediaPlayer 类的应用--音频播放器
mantouyouyou的博客
01-21 524
QMediaPlayer 类：媒体播放器，主要用于播放歌曲、网络收音机等功能。在pro文件中添加QT += multimedia。
MyCamera2_QT_
09-30
在本文中，我们将深入探讨如何使用Qt框架实现视频播放功能，包括开始、暂停以及通过滑块控制播放进度。Qt是一个跨平台的应用程序开发框架，广泛应用于C++编程，提供了丰富的图形用户界面（GUI）工具和多媒体支持。 ...
Qt实现天气预报、带歌词和播放列表显示音乐播放器、带播放列表视频播放器、录音机源代码
01-19
- 同音乐播放器，视频播放可能基于Qt多媒体框架，QMediaPlayer用于播放视频，QVideoWidget显示视频画面。 - 支持视频播放列表，QMediaPlaylist同样可以用于管理视频文件。 - 提供视频控制选项，如播放、暂停、快...
如何用QVideoWidget播放视频
04-29
本文将深入探讨如何使用QVideoWidget播放视频，包括基本使用方法、相关类和函数的介绍，以及可能遇到的问题和解决方案。 首先，我们需要包含必要的头文件，并引入Qt的Multimedia模块。在你的Qt项目中，确保`#...
基于qt的qmediaplayer类实现的一个播放器
12-01
基于qt的qmediaplayer类实现的一个音乐播放器，主要实现功能有歌词解析显示、数据库对播放列表静态保存记录，使用二级菜单对列表动态修改，本地搜索功能，以及播放器一些基本功能，上下曲，暂停|播放、进度条拖动，音量控制等，在线播放功能如何实现还在思考中。。。。欢迎大家一起来交流学习
基于QMediaplayer的播放器
12-02
是基于QMediaplayer的播放器，在QT5中可以运行的，请放心下载。
QMediaPlayer实现视频播放器功能
02-02
主要利用QMediaPlayer，实现各种格式视频的播放，包括音频，视频均正常播放，实现了功能：播放，暂停，多倍快进，上一个视频，下一个视频切换，拖拉进度条播放，声音进度条调节，播放记录，通过播放记录进行播放，等所有功能。如有问题，请私信留言，100%给你解决掉。
Qt5.8 QMediaPlayer 音乐播放器
08-12
使用 Qt 5中的QMediaPlayer 和QMediaPlaylist类 来播放音频 并使用数据库来保存播放列表 并实现了换肤 添加我喜欢等功能
Linux+Ubuntu+Qt实现视频播放器
04-27
通常会使用Qt的QMediaPlayer和QVideoWidget类来播放视频，同时可能涉及QMediaPlaylist以管理多个视频。 2. `music.cpp`: 虽然主要任务是视频播放，但此文件可能包含了音乐播放的相关逻辑，这可能是为了实现播放器的...
android MediaPlayer
fatherican的专栏
04-02 5909
转自http://www.cnblogs.com/gansc23/archive/2011/04/08/2009868.html MediaPlayer类可用于控制音频/视频文件或流的播放。关于如何使用这个类的方法还可以阅读VideoView类的文档。 1．状态图 对播放音频/视频文件和流的控制是通过一个状态机来管理的。下图显示一个MediaPlayer对象被支持的播放控
QVideoWidget
萧海的博客
09-09 2880
QVideoWidget类提供了一个小部件，它显示由媒体对象生成的视频。 将QVideoWidget附加到qmediao对象允许它显示该媒体对象的视频或图像输出。QVideoWidget通过在其构造函数中传递指向qmediao对象的指针来连接到媒体对象，并通过销毁QVideoWidget来分离。 player = new QMediaPlayer; playlist = new QMediaPlaylist(player); playlist->addMedia(QUrl("http://examp
QT QVideoWidget
Allen Roson
07-08 1738
QVideoWidget类提供了一个小部件，用于显示由媒体对象生成的视频。 将QVideoWidget附加到QMediaObject允许它显示该媒体对象的视频或图像输出。QVideoWidget通过在其构造函数中传递一个指向QMediaObject的指针来附加到媒体对象，并通过销毁QVideoWidget来分离。 player = new QMediaPlayer; playlist = new QMediaPlaylist(player); playlist->addMedia(Q...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值