编码与格式 / 系统课时
读取压缩数据包
读取压缩数据包
本课完成一个最小可运行的解复用循环:从媒体容器中持续读取 AVPacket,识别数据包所属流,并分别交给音频、视频或其他类型的处理逻辑,同时正确释放复用的数据包引用。
学习目标
- 理解
AVPacket、流索引与容器流之间的关系 - 使用
av_read_frame循环读取压缩数据 - 按流类型分发数据并管理数据包生命周期
AVPacket 在读取流程中的位置
av_read_frame 负责从 AVFormatContext 中读取下一个压缩数据包。它只完成解复用,不会把 H.264、AAC 等压缩数据还原成画面或采样,因此输出仍然是编码后的 AVPacket。
每个数据包通过 stream_index 指向 formatContext->streams 中的一条流。读取后先查出该流的 codec_type,再决定交给视频解码器、音频解码器,还是直接忽略字幕和数据流。

完整读取与分发示例
下面程序打开一个媒体文件,发现流信息后循环读取数据包。处理函数目前只打印元数据,下一步可以替换为解码、写文件或投递队列。保存为 packet_reader.c,可使用 cc packet_reader.c -o packet_reader $(pkg-config --cflags --libs libavformat libavcodec libavutil) 编译。
#include <inttypes.h>
#include <stdio.h>
#include <libavformat/avformat.h>
#include <libavutil/error.h>
static void print_error(const char *operation, int error_code) {
char buffer[AV_ERROR_MAX_STRING_SIZE] = {0};
av_strerror(error_code, buffer, sizeof(buffer));
fprintf(stderr, "%s failed: %s\n", operation, buffer);
}
static void handle_packet(const char *type, const AVPacket *packet) {
printf("stream=%d type=%s size=%d pts=%" PRId64 " dts=%" PRId64 "\n",
packet->stream_index,
type,
packet->size,
packet->pts,
packet->dts);
}
int main(int argc, char **argv) {
if (argc != 2) {
fprintf(stderr, "Usage: %s <media-file>\n", argv[0]);
return 1;
}
AVFormatContext *format_context = NULL;
AVPacket *packet = NULL;
int result = avformat_open_input(&format_context, argv[1], NULL, NULL);
if (result < 0) {
print_error("avformat_open_input", result);
return 1;
}
result = avformat_find_stream_info(format_context, NULL);
if (result < 0) {
print_error("avformat_find_stream_info", result);
avformat_close_input(&format_context);
return 1;
}
packet = av_packet_alloc();
if (packet == NULL) {
fprintf(stderr, "av_packet_alloc failed\n");
avformat_close_input(&format_context);
return 1;
}
while ((result = av_read_frame(format_context, packet)) >= 0) {
enum AVMediaType type =
format_context->streams[packet->stream_index]->codecpar->codec_type;
if (type == AVMEDIA_TYPE_VIDEO) {
handle_packet("video", packet);
} else if (type == AVMEDIA_TYPE_AUDIO) {
handle_packet("audio", packet);
} else {
handle_packet("other", packet);
}
// 处理完成后释放当前数据引用,packet 对象本身可继续复用。
av_packet_unref(packet);
}
if (result != AVERROR_EOF) {
print_error("av_read_frame", result);
}
av_packet_free(&packet);
avformat_close_input(&format_context);
return result == AVERROR_EOF ? 0 : 1;
}预期输出
stream=<ID> type=video size=<BYTES> pts=<PTS> dts=<DTS>
stream=<ID> type=audio size=<BYTES> pts=<PTS> dts=<DTS>
stream=<ID> type=video size=<BYTES> pts=<PTS> dts=<DTS><ID>、<BYTES>、<PTS> 和 <DTS> 由输入文件决定。部分数据包没有有效时间戳,此时可能打印 AV_NOPTS_VALUE 对应的负数,这不表示读取失败。
分发时的生命周期规则
示例在当前线程内同步处理数据包,因此分发完成后可以立即调用 av_packet_unref。该函数释放数据引用,但保留 AVPacket 对象,下一次 av_read_frame 可以继续复用它。
若数据包要进入异步队列,不能把同一个指针直接交给其他线程后立即解除引用。应先使用 av_packet_ref 创建独立引用,或使用 av_packet_clone 创建新的数据包对象,再由消费者负责释放。
av_read_frame返回负数时循环结束。AVERROR_EOF表示正常读完,其他错误应记录并按失败处理。
验证读取结果
运行 ./packet_reader <PATH> 后,应能看到音频和视频数据包交替出现。若只出现一种类型,先用 ffprobe <PATH> 检查文件是否确实包含另一条流;若程序立即结束,则重点检查输入路径、文件权限和容器格式支持。
读取循环只证明解复用成功,不代表数据已经解码。此时 packet->data 仍是压缩码流,不能直接当作 RGB 像素或 PCM 采样使用。