【Qt开发】Qt系统（十二）-＞ Qt视频

文章目录

• [1 -> 概述](#1 -> 概述)
• [2 -> 核心类与 API 详解](#2 -> 核心类与 API 详解)
• • [2.1 -> QMediaPlayer 类](#2.1 -> QMediaPlayer 类)
  • • [2.1.1 -> 主要功能：](#2.1.1 -> 主要功能：)
    • [2.1.2 -> 关键 API 方法：](#2.1.2 -> 关键 API 方法：)
  • [2.2 -> QVideoWidget 类](#2.2 -> QVideoWidget 类)
  • • [2.2.1 -> 主要功能：](#2.2.1 -> 主要功能：)
    • [2.2.2 -> 关键 API 方法：](#2.2.2 -> 关键 API 方法：)
  • [2.3 -> 关联播放器与视频窗口](#2.3 -> 关联播放器与视频窗口)
  • [2.4 -> 其他辅助类](#2.4 -> 其他辅助类)
• [3 -> 使用流程概述](#3 -> 使用流程概述)
• [4 -> 代码示例](#4 -> 代码示例)
• [5 -> 总结](#5 -> 总结)

---

1 -> 概述

Qt 作为一个功能全面的跨平台应用程序开发框架，其在多媒体领域的支持也相当成熟。视频播放作为现代应用程序中常见的功能之一，在 Qt 中得到了良好的封装与实现。通过 Qt 提供的多媒体模块，开发者可以轻松地在应用程序中嵌入视频播放功能，无论是用于媒体播放器、视频监控、在线教育还是其他多媒体交互场景。

Qt 的视频播放功能主要依赖于其 Multimedia 模块，该模块提供了一系列类来处理音频、视频和摄像头的输入输出。其中，视频播放的核心类是 QMediaPlayer 和 QVideoWidget。QMediaPlayer 负责媒体的加载、控制和状态管理，而 QVideoWidget 则提供了一个用于渲染视频画面的窗口部件。

与音频播放类似，使用 Qt 进行视频开发时，需要在项目配置文件（.pro）中添加相应的模块依赖，主要包括 multimedia 和 multimediawidgets。这样的模块化设计使得 Qt 的多媒体功能既能满足基本需求，又保持了良好的可扩展性和跨平台兼容性。

2 -> 核心类与 API 详解

2.1 -> QMediaPlayer 类

QMediaPlayer 是 Qt 多媒体模块中用于播放媒体内容的核心类。它支持多种媒体格式，包括本地文件和网络流，并提供了丰富的控制接口和状态通知机制。

2.1.1 -> 主要功能：

• 媒体加载与设置：支持通过 URL 或本地文件路径设置媒体源。
• 播放控制：提供播放、暂停、停止、跳转等基本控制功能。
• 状态与信号：通过信号机制通知媒体状态变化，如播放状态、缓冲进度、媒体长度等。
• 音量与播放速率控制：支持调节音量和播放速度。
• 错误处理：提供错误状态查询与错误信息获取。

2.1.2 -> 关键 API 方法：

方法名	说明
setMedia(const QMediaContent &media)	设置要播放的媒体源，可以是本地文件或网络 URL。
play()	开始或继续播放媒体。
pause()	暂停播放。
stop()	停止播放，并重置播放位置。
setPosition(qint64 position)	设置播放位置（毫秒）。
setVolume(int volume)	设置音量（0-100）。
setPlaybackRate(qreal rate)	设置播放速率（1.0 为正常速度）。
state()	返回当前播放状态（如播放、暂停、停止）。
mediaStatus()	返回媒体状态（如加载中、已加载、播放结束等）。

QMediaPlayer 还提供了多个信号，如 stateChanged()、mediaStatusChanged()、positionChanged() 等，方便开发者实时响应播放状态的变化。

2.2 -> QVideoWidget 类

QVideoWidget 是一个用于显示视频画面的 Qt 控件，继承自 QWidget。它可以与 QMediaPlayer 关联，作为视频输出的渲染目标。

2.2.1 -> 主要功能：

• 视频渲染 ：接收并显示来自 QMediaPlayer 的视频帧。
• 画面控制：支持画面缩放、纵横比调整、画面旋转等。
• 嵌入布局：可像普通 Qt 控件一样嵌入到布局中，与其他界面元素共存。

2.2.2 -> 关键 API 方法：

方法名	说明
setAspectRatioMode(Qt::AspectRatioMode mode)	设置画面纵横比模式（如保持原比例、拉伸填充等）。
setBrightness(int brightness)	调整画面亮度。
setContrast(int contrast)	调整对比度。
setHue(int hue)	调整色调。
setSaturation(int saturation)	调整饱和度。

2.3 -> 关联播放器与视频窗口

要使视频画面正常显示，必须将 QMediaPlayer 与 QVideoWidget 关联起来。这通过 QMediaPlayer::setVideoOutput() 方法实现：

mediaPlayer->setVideoOutput(videoWidget);

此后，mediaPlayer 播放的视频画面就会在 videoWidget 中渲染出来。

2.4 -> 其他辅助类

除了上述两个核心类外，Qt 多媒体模块还提供了一些辅助类，用于更精细地控制媒体播放：

• QMediaPlaylist：用于管理播放列表，支持顺序播放、循环播放、随机播放等模式。
• QAudioOutput：用于控制音频输出设备，在多音频流或高级音频处理场景中常用。
• QCamera 与 QVideoProbe：用于摄像头视频采集与帧级访问，适合视频通话或实时处理场景。

3 -> 使用流程概述

使用 Qt 实现视频播放功能一般遵循以下步骤：

1. 引入模块 ：在 .pro 文件中添加 multimedia 和 multimediawidgets 模块。
2. 创建播放器与视图 ：实例化 QMediaPlayer 和 QVideoWidget 对象。
3. 设置视频输出 ：调用 setVideoOutput() 将两者关联。
4. 设置媒体源 ：通过 setMedia() 指定要播放的视频文件或流地址。
5. 控制播放 ：调用 play()、pause()、stop() 等方法控制播放行为。
6. 响应状态：通过信号与槽机制监听播放状态、进度变化等事件，更新 UI 或执行相应逻辑。
7. 释放资源：在不需要时及时停止播放并释放相关对象。

4 -> 代码示例

widget.h

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>
#include <QHBoxLayout> //⽔平布局
#include <QVBoxLayout> //垂直布局
#include <QVideoWidget> //显⽰视频
#include <QMediaPlayer> //播放声⾳
#include <QPushButton> //按钮
#include <QStyle> //设置图标
#include <QFileDialog> //选择⽂件/⽂件夹

class Widget : public QWidget
{
    Q_OBJECT
public:
    Widget(QWidget *parent = nullptr);
    ~Widget();
    
public slots:
    void chooseVideo();
 
private:
    QMediaPlayer *mediaPlayer;
    QVideoWidget *videoWidget;
    QVBoxLayout *vbox;
    //创建两个按钮：选择视频按钮和开播放按钮
    QPushButton *chooseBtn,*playBtn;
};

#endif // WIDGET_H

widget.cpp

#include "widget.h"
#include <QMediaPlayer>
#include <QSlider>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
{
    //对象实例化
    mediaPlayer = new QMediaPlayer(this);
    videoWidget = new QVideoWidget(this);
    
    //设置播放画⾯的窗⼝
    videoWidget->setMinimumSize(600,600);
    
    //实例化窗⼝布局---垂直布局
    this->vbox = new QVBoxLayout(this);
    this->setLayout(this->vbox);
    
    //实例化选择视频按钮
    chooseBtn = new QPushButton("选择视频",this);
    
    //实例化播放按钮
    playBtn = new QPushButton(this);
    
    //设置图标代替⽂件
    playBtn->setIcon(this->style()->standardIcon(QStyle::SP_MediaPlay));
    
    //实例化⼀个⽔平布局，将以上控件放⼊⽔平布局中
    QHBoxLayout *hbox = new QHBoxLayout;
    
    //添加控件
    hbox->addWidget(chooseBtn);
    hbox->addWidget(playBtn);
    
    //将播放窗⼝和⽔平布局都添加到垂直布局中
    vbox->addWidget(videoWidget);
    
    //布局中添加布局
    vbox->addLayout(hbox);
    
    //将选择视频对应的按钮和槽函数进⾏关联
    connect(chooseBtn,&QPushButton::clicked,this,&Widget::chooseVideo);
}

void Widget::chooseVideo()
{
    //选择视频，返回⼀个播放视频的名字
    QString name = QFileDialog::getSaveFileName(this,"选择视频",".","WMV(*.wmv)");
    
    //设置媒体声⾳
    mediaPlayer->setMedia(QUrl(name));
    
    //输出视频画⾯
    mediaPlayer->setVideoOutput(videoWidget);
             
    //播放
    mediaPlayer->play();
}


Widget::~Widget()
{
}

5 -> 总结

Qt 的视频播放功能通过 QMediaPlayer 和 QVideoWidget 两个核心类，为开发者提供了一套完整且易于集成的解决方案。其优势在于：

• 跨平台兼容：同一套代码可在 Windows、macOS、Linux 乃至嵌入式平台上运行。
• 接口简洁：封装了底层复杂的媒体处理逻辑，开发者只需关注业务逻辑。
• 扩展性强：支持播放列表、音视频分离、实时摄像头输入等高级功能。
• 与 Qt 生态无缝集成：可轻松与 Qt 的信号槽、样式表、布局系统等结合，构建一致的 UI 体验。

当然，Qt 多媒体模块也有其局限性，例如对某些特殊格式或编码的支持可能依赖系统解码器，在极端性能要求的场景下可能需要结合更底层的库（如 FFmpeg）进行优化。

总体而言，对于大多数桌面端或嵌入式设备上的视频播放需求，Qt 提供的视频播放方案已经足够强大和稳定，是开发多媒体应用的可靠选择。

---

感谢各位大佬支持！！！
互三啦！！！