不能直接用avformatcontext::nb_streams或avstream::nb_frames计数,因其在mp4、mkv等格式中通常为0;应逐帧解码计数,即调用avformat_find_stream_info()后,循环av_read_frame()送包、avcodec_send_packet()/avcodec_receive_frame()收帧并计数,末尾flush解码器。

为什么不能直接用 AVFormatContext::nb_streams 或 AVStream::nb_frames
因为 nb_frames 在大多数封装格式(如 MP4、MKV)中默认为 0 —— 它依赖容器是否写入了帧数元数据,而 FFmpeg 解封装时通常不主动计算或填充它。硬读这个字段会返回 0 或错误值,不是可靠方案。
推荐做法:用 avcodec_send_packet() + avcodec_receive_frame() 逐帧解码计数
这是最通用、跨格式稳定的方法,尤其适合 H.264/H.265 等主流编码。关键点不是“跳过解码”,而是“必须触发完整解码流程”才能准确计数(B帧顺序、丢帧、关键帧间隔都会影响实际可解码帧数)。
- 先调用
avformat_find_stream_info()获取流参数,定位视频流索引 - 打开解码器后,用
av_read_frame()循环读取AVPacket,送入解码器 - 每次成功调用
avcodec_receive_frame(),计数器加 1;返回AVERROR(EAGAIN)表示暂无输出,需继续送包;返回AVERROR_EOF表示解码结束 - 注意:必须 flush 解码器——在读完所有 packet 后,再循环调用
avcodec_send_packet(nullptr)直到avcodec_receive_frame()返回AVERROR_EOF
性能敏感时可用 avformat_seek_file() + 关键帧粗略估算
如果只要大致帧数(比如做进度条),且视频有完整关键帧索引(如 MP4 的 stts box),可结合 AVStream::duration 和 AVStream::r_frame_rate 推算:total_frames ≈ duration * r_frame_rate.num / r_frame_rate.den。但误差可能达几十帧,尤其对 VFR(可变帧率)视频完全失效。
-
r_frame_rate是编码器声称的“名义帧率”,不是实际帧率 - 某些封装(如 FLV)连
duration都不准,需先调用avformat_find_stream_info()并检查返回值 - 不要信任
AVStream::avg_frame_rate—— 它常为 0 或被误设
常见崩溃点和内存管理细节
最容易出错的是 packet 和 frame 生命周期管理。FFmpeg 多数 API 不自动拷贝数据,av_read_frame() 返回的 AVPacket 必须用 av_packet_unref() 释放(哪怕只读不修改),否则反复调用会导致内存泄漏或野指针。
- 解码器上下文
AVCodecContext*必须用avcodec_open2()打开,不能仅靠avcodec_parameters_to_context() - 计数前务必检查
packet.stream_index == video_stream_index,忽略音频/字幕包 - 若视频含 B 帧,
avcodec_receive_frame()可能滞后多个 packet 才输出一帧,不能按 packet 数反推帧数
真要精确,就得老老实实解完所有帧。没捷径,也没轻量级替代方案。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











