【夏曹俊】C++编程FFMpegSDK美颜直播推流实战-基于qt5，opencv视频课

这套资料的主题很明确：用 Qt5 做界面与线程调度，用 FFmpeg SDK 完成解封装、解码、编码与推流，用 OpenCV 处理图像并叠加美颜滤镜，最终把一路本地视频或摄像头数据推成 RTMP 流。它不是泛泛的 C++ 语法课，而是一条完整的工程链路，从打开设备到字节出网，中间每一段都有可对照的源码。

技术栈分工与调用关系

先理清三个库在工程里各自负责什么，后面看代码才不会乱。

• FFmpeg 负责容器与编解码：avformat 处理输入输出上下文与 RTMP 协议，avcodec 负责 H.264 解码与编码，swscale 完成像素格式转换（比如解码出的 YUV420P 转成 RGB 给 OpenCV 用，美颜后再转回 YUV 送编码器）。
• OpenCV 负责帧级图像运算：Mat 承载 BGR 数据，双边滤波、高斯模糊、灰度图与查找表（LUT）实现磨皮与肤色调整，这类滤镜本质是对每个像素做邻域加权，放在 OpenCV 里写比手写循环省事得多。
• Qt5 负责工程外壳：用 QThread 或 moveToThread 把采集与推流放到独立线程，避免阻塞 UI；信号槽用来在采集线程和编码线程之间传递帧数据与状态，QTimer 控制帧率节奏。

三者之间的边界就是内存缓冲区。搞清楚一帧数据在哪个阶段是 AVFrame、哪个阶段是 cv::Mat、什么时候需要 av_frame_clone 或 memcpy，是这套代码能不能跑稳的关键。

可复用的模块划分

按功能切，这套工程大致能拆成几块可独立搬运的代码：

• 采集模块：输入源既可能是本地文件，也可能是摄像头设备，封装成一个统一的取帧接口，向上只暴露“给我下一帧”，这样换源时不用动后面的编码逻辑。
• 解码与颜色转换模块：读取一帧压缩包，送入解码器，拿到 AVFrame 后统一转成 OpenCV 能吃的格式。这部分重点看时间基（time_base）和 pts 的处理，转错会导致音画不同步或推流端报时间戳异常。
• 美颜滤镜模块：磨皮、美白、可选的瘦脸类几何变换，做成可串联的滤镜链，参数从配置读入，方便调试时单独开关某一层看效果。
• 编码与推流模块：设置编码器参数（分辨率、码率、GOP、preset），把处理后的帧送入编码器，取出 AVPacket 写入输出上下文。这里要留意 FLV/RTMP 对 H.264 的封装要求，SPS/PPS 要正确写入 extradata 或作为全局头发送。
• 线程与队列模块：生产者—消费者模型，采集端生产，编码端消费，中间用带锁队列缓冲，防止推流卡顿时丢帧或内存暴涨。

几个容易踩坑的工程点

对照源码实践时，下面几处值得反复看：AVFrame 的引用计数与释放时机，用错会内存泄漏或野指针；解码与编码两端的像素格式必须匹配，sws_getContext 的参数写反是最常见的花屏原因；pts 要按目标帧率重新计算，直接沿用解码时间戳会让推流端判定为异常；Qt 跨线程传自定义结构体需要 qRegisterMetaType，否则信号槽静默失败。这些问题在代码里都有对应处理，看的时候不要只跑通就过，最好把参数改坏一次，观察现象，理解为什么这么写。

自学路径建议

如果 C++ 基础还在，先把 std::thread、智能指针和 RAII 补上，再进入这套资料会轻松很多。学习顺序建议按数据流走：先单独跑通“读文件—解码—显示”，确认能拿到画面；再接入 OpenCV 做单帧美颜，肉眼比对前后差异；然后把处理后的帧重新编码写成本地文件，验证编码参数；最后才换成 RTMP 输出并在播放器里验证。每一步都能单独验证，出问题时定位范围小。资料里的视频片段按这个顺序拆解了接口调用与源码分析，适合边看边改，不要只当视频刷完。真正有价值的是把滤镜链和线程队列这两块抽出来，移植到自己项目里。