FFmpeg 推流到底做了什么？从 avformat_open_input 到 av_write_frame 的完整链路拆解

目录一、先给结论推流只有 4 个阶段二、完整调用流程标准 RTMP 推流版Step 0全局一次程序生命周期Step 1打开“输入源”文件 / 设备Step 2创建输出上下文推流核心Step 3为输出创建 AVStream非常关键Step 4打开 IO真正开始 TCP / RTMP HandshakeStep 5写 HeaderMetadata / FLV Tag / SPS/PPSStep 6主循环 —— 读 Packet → 时间戳 → 写出去6.1 读 Packet6.2 重算时间戳90% 推流问题在这里6.3 发送 Packet真正 push6.4 限速模拟实时Step 7写尾优雅断流三、最小函数调用清单四、推流常见翻车Top31. 不改 time_base2. 用 MP4 当推流格式3. 编码参数没继承全五、一句话工程总结觉得有用就请您帮忙点赞转发收藏吧您的鼓励是我创作的动力多谢看官。由于能力水平有限文中的错误或不严谨的地方在所难免还请批评指正。Fmpeg 推流本质是mux 时间戳 网络 IO不是编码活。核心链路就三步先avformat_network_init()再开输入拿AVStream用avformat_alloc_output_context2(flv)建输出avformat_new_stream()拷贝codecpar别忘extradata和time_baseavio_open()起 TCP/RTMP 握手接着avformat_write_header()写 Metadata/SPS-PPS主循环里av_read_frame()读包必须av_packet_rescale_ts()重算时基再用av_interleaved_write_frame()往出扔最后av_write_trailer()收尾。90% 的坑都在不改 time_base、用 MP4 推流、首帧非 keyframe。记住一句推的是 AVPacket调的是时间戳header 写成功才算上线。很多人第一次用 FFmpeg 推 RTMP / RTSP / SRT都是抄一条命令ffmpeg -re -i test.mp4 -c copy -f flv rtmp://xxx/live/stream然后一写代码就懵到底要调哪些函数顺序能不能乱为什么要 avformat_write_header这篇就用“推流视角”把 FFmpeg 的 API 调用链捋清楚不啰嗦按时间线来。一、先给结论推流只有 4 个阶段准备输入 ↓ 打开输出AVFormatContext *ofmt_ctx ↓ 构造输出流AVStream codecpar ↓ 写头 / 循环送 AVPacket / 写尾核心函数其实不到 10 个。二、完整调用流程标准 RTMP 推流版下面假设你已经有一个本地文件 / 摄像头 / 解码后帧源目标是rtmp://server/app/stream。Step 0全局一次程序生命周期avformat_network_init(); // RTMP/RTSP/UDP 必调很多 bug 的根源忘了这句RTMP 连不上还不报错。Step 1打开“输入源”文件 / 设备AVFormatContext *ifmt_ctx nullptr; avformat_open_input(ifmt_ctx, input_file, nullptr, nullptr); avformat_find_stream_info(ifmt_ctx, nullptr);目的拿到AVStream拿到codecpar宽高、codec_tag、bitrate、time_base如果是“自己造帧推流”采集→编码这步跳过后面手动建流。Step 2创建输出上下文推流核心AVFormatContext *ofmt_ctx nullptr; avformat_alloc_output_context2(ofmt_ctx, nullptr, flv, rtmp_url);重点flv→ RTMP 必须URL 决定 muxerrtmp:// → librtmp / native等价命令行-f flvStep 3为输出创建 AVStream非常关键AVStream *in_vst ifmt_ctx-streams[video_index]; AVStream *out_vst avformat_new_stream(ofmt_ctx, nullptr); avcodec_parameters_copy(out_vst-codecpar, in_vst-codecpar); out_vst-codecpar-codec_tag 0; // ★ muxer 自动处理 out_vst-time_base in_vst-time_base;经验点不要 new AVCodecContext推流只用codecparcodec_tag0能救很多 FLV / TS 奇葩错误音频同理再来一遍。Step 4打开 IO真正开始 TCP / RTMP HandshakeAVDictionary *opts nullptr; av_dict_set(opts, rw_timeout, 3000000, 0); // 3s 超时 avio_open2(ofmt_ctx-pb, rtmp_url, AVIO_FLAG_WRITE, nullptr, opts);到这里TCP 连了RTMP connect / createStream 完成了Step 5写 HeaderMetadata / FLV Tag / SPS/PPSAVDictionary *fopts nullptr; av_dict_set(fopts, flush_packets, 1, 0); avformat_write_header(ofmt_ctx, fopts);推流灵魂函数格式header 干了啥FLVScript Tag onMetaData AVC seq headerTSPAT/PMTMP4moov但 MP4 不适合真·推流header 没成功 播放端永远拉不开Step 6主循环 —— 读 Packet → 时间戳 → 写出去6.1 读 PacketAVPacket pkt; av_read_frame(ifmt_ctx, pkt);6.2 重算时间戳90% 推流问题在这里if (pkt.stream_index video_index) { pkt.stream_index out_vst-index; // 关键重新 scale time_base av_packet_rescale_ts(pkt, ifmt_ctx-streams[pkt.stream_index]-time_base, out_vst-time_base); }不 rescaleVLC 卡 1 帧ffplay 报Non-monotonic DTSOBS 能播但 Chrome MSE 挂6.3 发送 Packet真正 pushav_interleaved_write_frame(ofmt_ctx, pkt); av_packet_unref(pkt);为什么不用av_write_frameinterleaved自动 A/V 交错RTMP / TS 必选除非你手动严格交错6.4 限速模拟实时av_usleep(interval_us); // -re 的本质Step 7写尾优雅断流av_write_trailer(ofmt_ctx);RTMP发 deleteStreamFLVflush不写 trailer 也没事但服务器日志会丑三、最小函数调用清单avformat_network_init avformat_open_input avformat_find_stream_info avformat_alloc_output_context2 avformat_new_stream avcodec_parameters_copy avio_open avformat_write_header av_read_frame av_packet_rescale_ts av_interleaved_write_frame av_write_trailer avio_closep avformat_free_context四、推流常见翻车Top31. 不改 time_base现象能推拉流端卡死解法av_packet_rescale_ts2. 用 MP4 当推流格式现象等半天才播真相moov 在尾HTTP-FLV / RTMP 吃瘪解法flv / mpegts3. 编码参数没继承全extradata extradata_size profile levelH264 没拷 extradata → 播放端无解码参数五、一句话工程总结FFmpeg 推流不是“编码问题”是 mux timestamp network 问题。80% 代码在搬 AVPacket20% 在修时间戳。