文章目錄
- 一、opencv相關視頻播放類
- 1. `cv::VideoCapture` 類
- 主要構造方法：
- 主要方法：
- 2. 視頻播放基本流程
- 代碼示例：
- 3. 獲取和設置視頻屬性
- 4. 結合 FFmpeg 使用
- 5. OpenCV 視頻播放的局限性
- 6. 結合 Qt 實現更高級的視頻播放
- 總結
- 二、QT中的代碼實現
一、opencv相關視頻播放類
在 OpenCV 中，視頻播放主要依賴 cv::VideoCapture 類來進行視頻讀取和播放，同時使用 cv::imshow 進行幀顯示。下面是 cv::VideoCapture 相關的基本概念和用法解析。
1. cv::VideoCapture 類
cv::VideoCapture 用于從視頻文件、攝像頭或網絡流中讀取視頻數據。它可以處理多種格式的視頻文件，如 MP4、AVI、MKV 以及攝像頭流數據。
主要構造方法：
cv::VideoCapture(); // 空構造函數，需要后續調用 open()
cv::VideoCapture(const std::string& filename); // 通過文件路徑打開視頻
cv::VideoCapture(int deviceID); // 通過設備 ID 打開攝像頭
主要方法：
| 方法 | 作用 |
|---|---|
bool open(const std::string& filename) | 打開視頻文件 |
bool open(int deviceID) | 打開攝像頭 |
bool isOpened() const | 檢查是否成功打開 |
void release() | 釋放資源 |
bool read(cv::Mat& frame) | 讀取下一幀 |
bool grab() | 只抓取一幀數據 |
bool retrieve(cv::Mat& frame, int flag = 0) | 獲取當前抓取的幀 |
double get(int propId) | 獲取視頻參數 |
bool set(int propId, double value) | 設置視頻參數 |
2. 視頻播放基本流程
一個基本的視頻播放程序通常包含以下步驟：
- 打開視頻文件或攝像頭
- 逐幀讀取并顯示
- 監聽鍵盤輸入進行暫停、退出等操作
- 釋放資源
代碼示例：
#include <opencv2/opencv.hpp>
#include <iostream>int main() {cv::VideoCapture cap("video.mp4"); // 打開視頻文件if (!cap.isOpened()) {std::cerr << "無法打開視頻文件！" << std::endl;return -1;}cv::Mat frame;while (true) {cap >> frame; // 讀取一幀if (frame.empty()) break; // 讀取完畢則退出cv::imshow("Video Playback", frame);// 按 'q' 退出，延遲 30msif (cv::waitKey(30) == 'q') break;}cap.release();cv::destroyAllWindows();return 0;
}
3. 獲取和設置視頻屬性
可以使用 get() 和 set() 獲取或修改視頻參數：
double fps = cap.get(cv::CAP_PROP_FPS); // 獲取幀率
int width = cap.get(cv::CAP_PROP_FRAME_WIDTH); // 獲取寬度
int height = cap.get(cv::CAP_PROP_FRAME_HEIGHT); // 獲取高度
修改屬性（僅部分參數可修改）：
cap.set(cv::CAP_PROP_FRAME_WIDTH, 640);
cap.set(cv::CAP_PROP_FRAME_HEIGHT, 480);
4. 結合 FFmpeg 使用
OpenCV 默認使用系統自帶的編解碼器播放視頻，可能不支持所有格式。可以讓 OpenCV 依賴 FFmpeg 來解碼：
- Windows 用戶可以下載 FFmpeg 并設置環境變量。
- Linux/macOS 用戶可以使用
apt install ffmpeg或brew install ffmpeg進行安裝。
檢查 OpenCV 是否支持 FFmpeg：
std::cout << "FFmpeg support: " << cv::getBuildInformation() << std::endl;
5. OpenCV 視頻播放的局限性
- 性能問題：
cv::VideoCapture讀取和解碼較慢，不如 FFmpeg 專用庫快。 - 格式支持有限：依賴編譯選項和系統解碼器，部分格式可能不受支持。
- 音頻播放問題：OpenCV 僅處理視頻幀，不支持音頻，需要額外結合 FFmpeg 處理。
6. 結合 Qt 實現更高級的視頻播放
如果你在 C++/Qt 項目中使用 OpenCV，可以使用 QLabel 結合 QImage 進行視頻播放：
#include <opencv2/opencv.hpp>
#include <QImage>
#include <QPixmap>
#include <QLabel>void displayFrame(cv::Mat frame, QLabel* label) {cv::cvtColor(frame, frame, cv::COLOR_BGR2RGB);QImage img(frame.data, frame.cols, frame.rows, frame.step, QImage::Format_RGB888);label->setPixmap(QPixmap::fromImage(img));
}
總結
cv::VideoCapture是 OpenCV 進行視頻播放的核心類，可以從文件、攝像頭讀取視頻。- 基本流程 是打開視頻 -> 逐幀讀取 ->
cv::imshow()顯示 -> 監聽cv::waitKey()控制播放。 - 可以獲取/設置視頻屬性，如幀率、寬高等。
- 性能有限，如果對播放速度、格式兼容性有較高要求，建議結合 FFmpeg 或 Qt 多媒體模塊。
二、QT中的代碼實現
#include "widget.h"
#include "ui_widget.h"
#include <QImage>
#include <QPixmap>
#include <QDebug>Widget::Widget(QWidget *parent): QWidget(parent),ui(new Ui::Widget),label(new QLabel(this)),btnPlayPause(new QPushButton("暫停", this)), // 按鈕默認顯示“暫停”cap("/mnt/app/1.mp4"), // 本地視頻路徑timer(new QTimer(this)),isPlaying(true)
{ui->setupUi(this);setFixedSize(700, 550); // 固定窗口大小// 設置 QLabel 位置和大小label->setGeometry(10, 10, 640, 480);// 設置播放/暫停按鈕btnPlayPause->setGeometry(300, 500, 100, 40);connect(btnPlayPause, &QPushButton::clicked, this, &Widget::togglePlayback);// 檢查視頻文件是否打開成功if (!cap.isOpened()) {qWarning("無法打開視頻文件！");return;}// 啟動定時器，每 30ms 更新一幀（大約 33 FPS）connect(timer, &QTimer::timeout, this, &Widget::updateFrame);timer->start(30);
}Widget::~Widget()
{cap.release(); // 釋放 OpenCV 資源delete timer;delete ui;
}void Widget::updateFrame()
{if (!isPlaying) return; // 如果暫停，則不更新幀cv::Mat frame;cap >> frame; // 讀取一幀if (frame.empty()) {qWarning("視頻播放結束！");timer->stop(); // 停止定時器return;}// OpenCV 默認是 BGR 顏色格式，轉換為 RGBcv::cvtColor(frame, frame, cv::COLOR_BGR2RGB);// 將 Mat 轉換為 QImageQImage img(frame.data, frame.cols, frame.rows, frame.step, QImage::Format_RGB888);// 顯示圖像，并適配 QLabel 尺寸label->setPixmap(QPixmap::fromImage(img).scaled(label->size(), Qt::KeepAspectRatio));
}void Widget::togglePlayback()
{isPlaying = !isPlaying;btnPlayPause->setText(isPlaying ? "暫停" : "播放"); // 更新按鈕文本
}#ifndef WIDGET_H
#define WIDGET_H#include <QWidget>
#include <QLabel>
#include <QPushButton>
#include <QTimer>
#include <opencv2/opencv.hpp>QT_BEGIN_NAMESPACE
namespace Ui {
class Widget;
}
QT_END_NAMESPACEclass Widget : public QWidget
{Q_OBJECTpublic:Widget(QWidget *parent = nullptr);~Widget();private slots:void updateFrame(); // 更新視頻幀void togglePlayback(); // 切換播放/暫停狀態private:Ui::Widget *ui;QLabel *label; // 用于顯示視頻的QLabelQPushButton *btnPlayPause; // 播放/暫停按鈕cv::VideoCapture cap; // OpenCV視頻捕獲對象QTimer *timer; // 用于定時刷新視頻幀bool isPlaying; // 播放狀態標記
};#endif // WIDGET_H
