使用QMediaPlayer可以进行视频文件解码，视频播放必须将视频帧在某个界面组件上显示， 有QVideoWidget和QGraphicsVideoItem两种视频显示组件，也可以从这两个类继承，自定义视频显示组件。

QMediaPlayer也可以结合QMediaPlaylist实现视频文件列表播放。

1.视频播放器实例程序

QVideoWidget是用于显示视频的界面组件，要在项目中使用QVideoWidget，需要在项目配置 文件中添加下面一行语句：

Qt = multimediawidgets

使用QMediaPlayer和QVideoWidget实现的一个视频播放器实例程序，运行时界面如下图所示。该程序没有使用QMediaPlaylist，只播放单个文件。

界面的主体部分是一个QmyVideoWidget类组件，是从QVideoWidget继承的自定义视频显示组件，重载了mousePressEvent()事件，鼠标单击可以暂停或继续播放；重载了keyPressEvent()事件，在全屏状态下按ESC键可以退出全屏。原始的QVideoWidget类没有这些功能。

2.主窗口设计

主窗口是基于QMainWindow的类MainWindow，采用UI设计器设计界面。在设计视频显示组件时，在窗体上放置一个QWidget组件，然后提升为QmyVideoWidget类。

主窗口功能主要是使用一个QMediaPlayer组件播放单个视频文件。媒体播放类QMediaPlayer的功能在介绍音频播放时（从零开始学Qt（92）：使用QMediaPlayer播放音乐文件）已经详细介绍。

MainWindow类定义如下（忽略了自动生成的界面组件的槽函数定义）：

class MainWindow : public QMainWindow{ Q_OBJECTpublic: MainWindow(QWidget *parent = nullptr); ~MainWindow();private: Ui::MainWindow *ui; QMediaPlayer *player;//视频播放器 QString durationTime; QString positionTime;private slots: //自定义槽函数 void onStateChanged(QMediaPlayer::State state); void onDurationChanged(qint64 duration); void onPositionChanged(qint64 position);};

MainWindow类的功能实现代码如下，只播放单个文件，比音频播放器功能简单，所以具体代码的功能这里不再赘述。

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow){ ui->setupUi(this); player = new QMediaPlayer(this);//创建视频播放器 、 player->setNotifyInterval(2000);//信息更新周期 2000 ms player->setVideoOutput(ui->videoWidget); //视频显示组件 ui->videoWidget->setMediaPlayer (player) ;//设置显示组件的关联播放器 connect(player,SIGNAL(stateChanged(QMediaPlayer::State)), this, SLOT(onStateChanged(QMediaPlayer::State))); connect(player,SIGNAL(positionChanged(qint64)), this, SLOT(onPositionChanged(qint64))); connect(player,SIGNAL(durationChanged(qint64)), this, SLOT(onDurationChanged(qint64)));}void MainWindow::onStateChanged(QMediaPlayer::State state){//播放器状态变化 ui->btnPlay->setEnabled(!(state==QMediaPlayer::PlayingState)); ui->btnPause->setEnabled(state==QMediaPlayer::PlayingState); ui->btnStop->setEnabled(state==QMediaPlayer::PlayingState);}void MainWindow::onDurationChanged(qint64 duration){//文件时长变化 ui->sliderPosition->setMaximum(duration); int secs=duration/1000;//秒 int mins=secs/60; //分钟 secs=secs % 60;//余数秒 durationTime=QString::asprintf("%d:%d",mins,secs); ui->labRatio->setText(positionTime "/" durationTime);}void MainWindow::onPositionChanged(qint64 position){//文件播放位置变化 if(ui->sliderPosition->isSliderDown()) return; //如果正在拖动滑条，退出 ui->sliderPosition->setSliderPosition(position); int secs=position/1000;//秒 int mins=secs/60; //分钟 secs=secs % 60;//余数秒 positionTime=QString::asprintf("%d:%d",mins,secs); ui->labRatio->setText (positionTime "/" durationTime);}

几个按钮的相应代码如下：

void MainWindow::on_btnOpen_clicked(){//打开文件 QString curPath=QDir::homePath(); //获取系统当前目录 QString dlgTitle="选择视频文件"; //对话框标题 QString filter="wmv(*.wmv);;mp4(*.mp4);;(*.*)"; QString aFile=QFileDialog::getOpenFileName(this, dlgTitle, curPath, filter); if(aFile.isEmpty()) return; QFileInfo fileInfo(aFile); ui->labMedia->setText(fileInfo.fileName()); player->setMedia(QUrl::fromLocalFile(aFile));//设置播放文件 player->play();}void MainWindow::on_btnPlay_clicked(){//播放 player->play();}void MainWindow::on_btnPause_clicked(){//暂停 player->pause();}void MainWindow::on_btnStop_clicked(){//停止 player->stop();}void MainWindow::on_sliderPosition_valueChanged(int value){//播放位置 player->setPosition(value);}void MainWindow::on_btnMute_clicked(){//静音按钮 bool mute=player->isMuted(); player->setMuted(!mute); if(mute) ui->btnMute->setText("√"); else ui->btnMute->setText("×"); }void MainWindow::on_sliderVolumn_valueChanged(int value){//调节音量 player->setVolume(value);}void MainWindow::on_btnFullScreen_clicked(){//全屏按钮 ui->videoWidget->setFullScreen(true);}

3.自定义视频显示组件QmyVideoWidget

原始的QVideoWidget在全屏后无法按Esc键退出全屏状态，为了实现按键和鼠标控制功能，从QVideoWidget继承了一个类QmyVideoWidget，其定义如下：

class QmyVideoWidget : public QVideoWidget{private: QMediaPlayer *thePlayer;protected: void keyPressEvent(QKeyEvent *event); void mousePressEvent(QMouseEvent *event);public: QmyVideoWidget(QWidget *parent = Q_NULLPTR); void setMediaPlayer(QMediaPlayer *player);};

私有变量thePlayer是关联的视频播放器，在开始播放之前由主窗口程序调用setMediaPlayer()进行设置，以便在QmyVideoWidget里对播放器进行控制。

下面是QmyVideoWidget类的实现代码：

void QmyVideoWidget::keyPressEvent(QKeyEvent *event){//按键事件，ESC退出全屏状态 if((event->key() == Qt::Key_Escape) && ( isFullScreen() ) ){ setFullScreen(false); event->accept(); QVideoWidget::keyPressEvent(event); }}void QmyVideoWidget::mousePressEvent(QMouseEvent * event){//鼠标事件，单击控制暂停和继续播放 if(event->button()==Qt::LeftButton){ if(thePlayer->state()==QMediaPlayer::PlayingState) thePlayer->pause(); else thePlayer->play(); } QVideoWidget::mousePressEvent(event);}void QmyVideoWidget::setMediaPlayer(QMediaPlayer *player){//设置播放器 thePlayer=player;}

————————————————

觉得有用的话请关注点赞，谢谢您的支持！

对于本系列文章相关示例完整代码有需要的朋友，可关注并在评论区留言！