Qt+MinGW32+Windows+FFmpeg集成指南:RTSP预览编译踩坑实录
简介这是一套基于Qt与MinGW32工具链面向Windows平台的FFmpeg RTSP视频流播放示例工程主要帮助开发者快速掌握在Qt中集成FFmpeg并实时显示RTSP流的方法。项目代码精简在Windows下可直接编译通过运行且视频响应速度明显优于VLC、QTAV等常见播放方案适合需要自研轻量级视频预览或监控界面的Qt中级开发者参考。压缩包共103个文件约11.58MB其中包含81个C头文件、4个cpp源文件、5个FFmpeg动态库及5个静态导入库并附带工程文件、UI界面、图标、样式表和说明文档结构清晰便于定位。示例支持三通道同步显示同一视频流可单击截图按钮把画面保存至最后通道双击单通道可最大化显示。需要注意打开工程后务必取消影子构建若切换到Linux则需替换对应FFmpeg库文件。资源已有1163人学习具备较高的实用参考价值。 前一阵子我把一个 Windows 上的 RTSP 摄像头预览小工具换到新电脑重新编译Qt 是现成的MinGW 也是现成的结果 FFmpeg 一接进来就各种亮红灯。要说功能代码本身并不复杂真正折腾人的是 Qt MinGW32 Windows FFmpeg 这套组合里的版本、位数、链接方式必须严丝合缝。下面这套环境从报错报到麻木到最终跑通的完整记录给同样正在搭这个组合的人一个参考。适合刚把 Qt 装好、正打算集成 FFmpeg 做 RTSP 拉流播放或者已经卡在某一个编译错误上的朋友。1. 先拆一下“保证编译可用”到底卡在哪1.1 网上的轮子很多装上却转不起来搜这个关键词的时候你会看到大量教程。但实际照着做很多人会卡在同一个地方教程用的是 MSVC 版的 Qt你装的是 MinGW 版教程在 Linux 上演示你在 Windows 上搞教程默认你会自己编译 FFmpeg你只是想要一个能用的库文件。这些差异叠加起来就是“我明明按照步骤做了为什么还是编译不过”。我见过的最典型翻车三连装错了 Qt 工具链。Qt 安装器里组件很多有人图省事勾了 MSVC 2019结果后面用 MinGW 语法写.pro链接阶段大量报错。FFmpeg 位数和 Qt 不一致。Qt 是 32 位FFmpeg 下的是 win64 包链接时出现各种undefined reference而且报错信息不会直接告诉你“位数不匹配”。编译过了运行却提示缺avformat-*.dll。这是库路径和运行时 DLL 的问题跟代码一点关系都没有但足够让人怀疑人生。这些现象说明一件事“编译可用”不是“我代码写完了”的意思而是整个工具链、依赖库、运行环境都对齐了。等这几个环节全部理顺后面的开发反而很顺。1.2 “可用”的三重匹配位数、工具链、API我把这套组合拆成三个必须匹配的维度位数匹配Qt 编译出来的程序是多少位FFmpeg 库就必须是多少位。MinGW32 配 win32 库MinGW64 配 win64 库混用必挂。工具链匹配MinGW 使用 GCC 的库格式通常是.a或者.dll.aMSVC 使用.lib。这两种格式不能混着链接。很多人从 MSVC 教程里复制了avformat.lib的写法拿到 MinGW 下自然找不到。API 版本匹配FFmpeg 的大版本更新会调整接口。比如老教程里的avcodec_decode_video2在新版本里已经移除了av_register_all在 4.0 之后变成了空操作。你用的头文件和库版本必须和你参考的代码对得上。理解了这三条后面每一步都不会莫名其妙。接下来我按顺序讲怎么把这套组合配稳妥。2. 版本选型与安装锁定组合是省时间的开始2.1 Qt与MinGW工具链建议锁5.15.2 MinGW 8.1.0如果你没有特殊理由我建议直接锁Qt 5.15.2 LTS Qt 安装器自带的 MinGW 8.1.0。这套组合网上资料最多踩坑别人都踩完了哪怕是五年前的教程大部分也适用。在 Qt 官方安装器里勾选组件时除了要选Qt 5.15.2下面的MinGW 8.1.0 32-bit或者64-bit还要记得展开Tools节点勾选对应的MinGW 8.1.0编译器工具链。很多新手只勾了 Qt 库没勾编译器打开 Qt Creator 后发现 Kit 列表里没有任何可用的工具链这就是原因。这里要特别说明标题里的 MinGW32。如果你说的 MinGW32 是指 32 位工具链那就在安装器里明确选MinGW 8.1.0 32-bit如果只是大家叫顺口的“MinGW 环境”那 64 位也一样用。下面的流程两者通用关键是后面位数必须自洽。2.2 FFmpeg的Windows二进制从哪下载、选哪个包FFmpeg 官方只提供源码Windows 下一般用社区预编译包。我常用的是 BtbN 的 GitHub releases或者 gyan.dev 的构建。以 BtbN 为例下载时会看到类似这样的命名ffmpeg-master-latest-win32-gpl-shared.zipffmpeg-master-latest-win64-gpl-shared.zip注意两个关键词win32/win64决定位数shared决定包结构。我建议选shared而不是static。shared 包解压后有三个目录include头文件、lib导入库、bin运行时 DLL。编译时用前两个运行时依赖第三个。static 包只有一个超大 exe开发期不好用分发时反而是一种选择。版本方面我推荐 FFmpeg5.1.x 或 6.1.x。这两个版本 API 相对成熟本文下面给的代码在这两个版本上都能编译通过。不建议一上来就用 7.x 最新版新版本可能有接口调整容易把时间浪费在无关的兼容性问题上。2.3 32位还是64位这个坑必须第一时间排除为了不重蹈“折腾两天最后发现位数不对”的覆辙先做一次检查。打开命令行进入 Qt 自带的 MinGW bin 目录执行gcc -dumpmachine输出i686-w64-mingw32代表 32 位输出x86_64-w64-mingw32代表 64本文还有配套的精品资源点击获取

相关新闻

C++多线程日志库ylog:从printf到可靠落盘的工程实践

C++多线程日志库ylog:从printf到可靠落盘的工程实践

简介:ylog 是一份基于标准库实现的 C 轻量级日志类源码包,面向需要在 Windows 与 Linux 平台快速集成日志功能的 C 开发者,特别适合中小型项目、工具类程序或日志模块启蒙学习。整个核心实现只集中在一个头文件中,全程序仅 60 多行…

2026/11/18 7:38:57 阅读更多 →
Keil C51与uVision2实用指南:避开破解坑,从安装到调试一次讲清

Keil C51与uVision2实用指南:避开破解坑,从安装到调试一次讲清

简介:这是面向51单片机初学者的Keil C51完全破解版uVision2压缩包,用来解决开发软件安装与授权限制的常见痛点,让用户跳过环境配置的烦琐步骤,专注于C语言编程和硬件控制。uVision2是Keil C51的经典版本,界面简洁、功能…

2026/11/18 11:14:23 阅读更多 →
网易MC模组《青春岁月》替身机制测评:安装、性能与排查

网易MC模组《青春岁月》替身机制测评:安装、性能与排查

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/21 0:09:39 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻