编码与格式 / 系统课时
FFmpeg 核心对象
FFmpeg 核心对象
本课用一条最小解码链路串起 FFmpeg 的四个核心对象,说明它们分别管理容器、解码器、压缩数据和原始数据。读完后,你能判断数据当前处于哪一层,并按正确顺序分配、复用和释放对象。
学习目标
- 区分
AVFormatContext、AVCodecContext、AVPacket和AVFrame的职责 - 理解压缩数据从文件进入解码器并变成原始帧的过程
- 掌握对象复用、清理和释放的基本规则
四个对象如何协作
AVFormatContext 面向媒体容器,负责打开输入、读取流信息,并从文件或网络中取出一个个压缩包。它不负责把 H.264、AAC 等编码数据还原为图像或采样。
AVCodecContext 面向某一路编解码器,保存编码格式、宽高、采样率、线程数等运行参数。每个需要解码的音频流或视频流通常各有一个独立上下文。
AVPacket 承载解复用后得到的压缩数据,例如一段 H.264 码流或 AAC 数据。AVFrame 承载解码后的原始数据,例如 YUV 图像平面或 PCM 音频采样。

可以把四者记成一句话:格式上下文负责“从哪里读、读哪一路”,数据包负责“搬运压缩数据”,编解码上下文负责“如何解码”,数据帧负责“保存解码结果”。
对象与流的对应关系
一个 AVFormatContext 可以包含多个 AVStream,例如一路视频、两路音频和一路字幕。AVStream 描述容器中的逻辑流,其 codecpar 保存初始化解码器所需的静态参数。
AVCodecContext 不应被所有流共用。定位目标流后,应依据该流的 codecpar 创建并配置对应的解码上下文。随后只把 stream_index 匹配的数据包送入该上下文。
| 对象 | 典型数量 | 保存的数据 | 主要职责 |
|---|---|---|---|
AVFormatContext |
每个输入一个 | 容器和流信息 | 打开输入、探测流、读取数据包 |
AVCodecContext |
每个目标流一个 | 解码状态和参数 | 接收压缩包并输出原始帧 |
AVPacket |
通常循环复用一个 | 压缩数据 | 在解复用器与解码器之间传递数据 |
AVFrame |
通常循环复用一个或多个 | 原始音视频数据 | 承接并交给渲染、重采样或转换模块 |
解码循环中的最小配合
下面是片段示例,假设 format_ctx、decoder_ctx、target_stream_index 已完成初始化,process_frame 是应用自行实现的帧处理函数。代码重点是展示对象之间的调用顺序,不能脱离这些上下文独立运行。
AVPacket *packet = av_packet_alloc();
AVFrame *frame = av_frame_alloc();
while (av_read_frame(format_ctx, packet) >= 0) {
if (packet->stream_index == target_stream_index) {
int ret = avcodec_send_packet(decoder_ctx, packet);
if (ret >= 0) {
while (avcodec_receive_frame(decoder_ctx, frame) >= 0) {
process_frame(frame);
av_frame_unref(frame);
}
}
}
// 释放本次引用的数据,保留对象本身供下一轮复用
av_packet_unref(packet);
}
av_frame_free(&frame);
av_packet_free(&packet);av_read_frame 把压缩数据写入 AVPacket;avcodec_send_packet 将数据送入解码器;avcodec_receive_frame 可能输出零帧、一帧或多帧,因此必须循环接收。处理完一帧后调用 av_frame_unref,而不是每次重新分配对象。
生命周期与常见错误
av_packet_unref 和 av_frame_unref 清除当前引用,使对象可以复用;av_packet_free 和 av_frame_free 才是真正销毁对象。把两组函数混用,容易造成重复分配、内存增长或悬空引用。
数据包与数据帧内部通常采用引用计数。将其交给异步线程长期持有时,应使用引用或复制 API 延长数据生命周期,不能在原线程 unref 后继续访问原缓冲区。
Tips:关闭顺序通常与创建顺序相反。先释放帧和包,再释放编解码上下文,最后使用
avformat_close_input关闭格式上下文。