保姆级教程：用FFmpeg API将RTSP/HLS流实时录制成MP4（附完整C代码）
从零构建RTSP/HLS流录制工具：FFmpeg API实战指南
在视频监控和直播领域，实时录制网络视频流是常见需求。无论是安防摄像头还是在线直播平台，都需要将RTSP或HLS流可靠地保存为MP4文件。本文将带你从零开始，用FFmpeg API构建一个专业的流录制工具。
1. 环境准备与项目搭建
首先需要配置开发环境。FFmpeg作为多媒体处理的瑞士军刀，提供了丰富的API供我们调用。对于C/C++项目，我们需要：
- 下载FFmpeg开发包（建议使用4.x以上版本）
- 配置编译环境（Windows下可使用MSYS2或Visual Studio）
- 设置正确的包含路径和库链接
关键依赖：
# Ubuntu下安装开发依赖 sudo apt-get install libavformat-dev libavcodec-dev libavutil-dev项目目录结构建议如下：
/rtsp_recorder ├── include/ # FFmpeg头文件 ├── lib/ # FFmpeg库文件 ├── src/ │ ├── main.c # 主程序 │ └── recorder.c # 录制核心逻辑 └── Makefile2. FFmpeg核心API解析
理解FFmpeg的工作流程是关键。录制网络流主要涉及以下几个核心组件：
AVFormatContext：格式上下文，管理输入输出AVCodecParameters：编解码参数AVPacket：压缩后的数据包
初始化流程：
AVFormatContext *input_ctx = NULL; AVFormatContext *output_ctx = NULL; // 打开输入流 avformat_open_input(&input_ctx, rtsp_url, NULL, NULL); avformat_find_stream_info(input_ctx, NULL); // 创建输出上下文 avformat_alloc_output_context2(&output_ctx, NULL, NULL, output_file);3. 流配置与参数设置
正确配置视频流参数是保证录制质量的关键。对于H.264/H.265流，需要特别注意：
- 关键帧识别：通过SPS/PPS(VPS)判断流格式
- 时间基准(time_base)：确保时间戳计算准确
- extradata设置：包含重要的编解码信息
参数配置示例：
AVStream *out_stream = avformat_new_stream(output_ctx, NULL); avcodec_parameters_copy(out_stream->codecpar, in_stream->codecpar); // 特别处理H.265的AVI格式 if(codec_id == AV_CODEC_ID_HEVC && format_is_avi) { out_stream->codecpar->codec_tag = MKTAG('H','2','6','5'); }4. 实时录制核心逻辑
录制过程需要处理以下几个关键问题：
- 数据包处理：正确解析和写入视频帧
- 时间戳计算：保证视频同步和正确时长
- 错误恢复：网络中断时的重连机制
数据包写入示例：
AVPacket pkt; while(av_read_frame(input_ctx, &pkt) >= 0) { if(pkt.stream_index == video_stream_idx) { // 转换时间戳 pkt.pts = av_rescale_q(pkt.pts, input_ctx->streams[video_stream_idx]->time_base, output_ctx->streams[0]->time_base); pkt.dts = pkt.pts; av_interleaved_write_frame(output_ctx, &pkt); } av_packet_unref(&pkt); }5. 完整工程实现
下面提供一个可直接编译运行的完整示例。该实现包含：
- 网络流连接管理
- 录制状态控制
- 错误处理和日志记录
核心结构体设计：
typedef struct { AVFormatContext *input_ctx; AVFormatContext *output_ctx; int video_stream_idx; int running; pthread_t thread; } StreamRecorder;录制线程函数：
void* recording_thread(void *arg) { StreamRecorder *rec = (StreamRecorder*)arg; AVPacket pkt; while(rec->running) { int ret = av_read_frame(rec->input_ctx, &pkt); if(ret < 0) { // 处理错误或重连 break; } if(pkt.stream_index == rec->video_stream_idx) { // 处理并写入视频帧 process_video_packet(rec, &pkt); } av_packet_unref(&pkt); } return NULL; }6. 高级功能与优化
对于生产环境应用，还需要考虑以下高级功能：
- 分段录制：按时间或大小分割文件
- 元数据写入：记录摄像头信息等
- 性能优化：内存管理和IO优化
分段录制实现思路：
void check_file_split(StreamRecorder *rec) { time_t now = time(NULL); if(now - rec->last_split_time > SPLIT_INTERVAL) { close_current_file(rec); open_new_file(rec); rec->last_split_time = now; } }在实际项目中，我发现最容易出错的地方是时间戳处理。特别是在长时间录制时，确保pts持续递增且不发生回绕至关重要。一个实用的技巧是在每次文件分割时记录最后一个pts值，并在新文件中以此为基准继续递增。