音视频开发项目-1开篇

开篇：拿到这个项目，我是怎么下手的

系列目录：

• 01 开篇：项目初印象（本篇）
• 02 从主函数开始看起
• 03 RKMedia 三大模块初始化（VI / VENC / RGA）
• 04 通道绑定与任务分发
• 05 数据是怎么流动的：三大工作线程
• 06 VIDEO_QUEUE：生产者消费者队列
• 07 FFmpeg 推流侧的初始化
• 08 AVPacket 搬运工与写帧
• 09 Makefile、交叉编译与踩坑总结

---

一、这个项目是干嘛的

一句话：RV1126 开发板采集摄像头画面 → 硬件编码成 H264 → 用 FFmpeg 打包推到流媒体服务器（RTMP）。

说白了就是一块板子当"直播摄像头"用。README 里写得很直白：

这个项目使用的是 RV1126 视频编码+音频编码，然后通过交叉编译的 ffmpeg 作为推流器进行推流，进行 RTMP 推流。主函数是 rv1126_ffmpeg_main.cpp，大家先从这个位置开始看。

另外 README 还提了一嘴：SRT 协议还没完全搞定，后面会持续改。这个坑我留到最后一篇说。

二、第一件事：看文件名，别急着看代码

刚打开项目目录的时候，十几个 cpp 文件堆在一起，直接硬看代码肯定懵。我的做法是先看文件名规律，结果发现这个项目的命名挺讲究的，甚至项目里还有一份《文件命名前缀规范说明.md》专门解释这件事：

前缀	是什么层次	干嘛的
rv1126_	硬件层	芯片平台相关，比如 ISP 图像处理
rkmedia_	SDK 层	Rockchip 的 RKMedia API 封装
ffmpeg_	第三方库层	推流相关的数据结构（队列）
sample_	官方示例	Rockchip 给的参考代码，基本不动

它给的类比我觉得很形象：

rv1126_*  = 地基和框架（硬件基础）
rkmedia_* = 水电管道（SDK 基础设施）
ffmpeg_*  = 装修材料（第三方功能库）
sample_*  = 装修图纸（官方参考方案）
main.cpp  = 房子整体（你的应用）

有了这个地图，看代码的顺序就出来了：从 main 开始，先往硬件方向走一遍（初始化），再沿着数据流走一遍（线程和队列），最后到网络那一头（FFmpeg 推流）。这个系列博客就按这个顺序写。

三、整体架构：一张图说清楚

几个我一开始没意识到、后来才摸出味道的点：

1. 两路码流不是两次采集。摄像头只采一次 1080P，高清路直接编码；低清路靠 RGA 硬件缩放成 720P 再进第二个编码通道。一路传感器出两档清晰度，直播场景很典型。
2. RKMedia 和 FFmpeg 之间靠队列解耦。硬件那头出数据的节奏和网络上消费的节奏肯定对不上，中间塞了个带锁的队列，两边各跑各的线程。
3. FFmpeg 在这里不负责编码 。编码是 RV1126 的硬件 VENC 干的，FFmpeg 只干"搬运 + 打包 + 发网络"的活。我一开始还以为要用 FFmpeg 编码，看了半天发现 avcodec_open2 打开编码器只是为了拿它填参数，一帧都没编过。

四、看代码的实际路径

记录一下我真实的阅读顺序，给以后拿到陌生项目参考：

1. README.md → 知道项目干什么的，入口在哪
2. 文件命名前缀规范说明.md → 建立文件地图
3. rv1126_ffmpeg_main.cpp → 只有 30 多行，看程序骨架
4. rkmedia_module_function.cpp → 所有硬件模块的参数都在这，分辨率/帧率/码率一目了然
5. rkmedia_assignment_manage.cpp → 绑定关系 + 创建了哪些线程
6. rkmedia_data_process.cpp → 线程函数的实现，数据流的核心
7. ffmpeg_video_queue.cpp / ffmpeg_audio_queue.cpp → 独立的小组件，纯数据结构
8. rkmedia_ffmpeg_config.cpp → FFmpeg 侧的初始化
9. Makefile → 最后看，确认链接了哪些库

这个顺序的基本逻辑：先骨架再血肉，先硬件侧再网络侧，顺着数据流方向走。

五、这个系列怎么写

后面每篇我会按这个套路来：

• 这部分代码在干嘛（一句话）
• 关键代码贴出来，配我的理解
• 我卡住过 / 想错过的点（这个最重要，光看别人讲懂了不算懂）
• 留下的疑问（有些问题我到现在也没完全确认，写出来防止自己忘了）

声明一下：我是边学边写的，理解不一定全对，发现的坑也会如实记录。如果哪篇有说错的地方，以后回头改。

---

下一篇：从主函数开始看起 ------ 一个 30 行的 main 里藏着整个程序的生命周期。