其实，

在完成了 FFmpeg 解码 的学习后接下来往往是把已经封装好的视频文件进行解复用再配合 SDL 将画面实时渲染出来。话说回来，很多同学在实际开发中会遇到：

• 不清楚解复用到底在哪一步。导致读取不到数据包，
• 函数返回值忽视错误码，程序直接崩溃。怎么说呢，
• 流索引获取错误。导致音视频混淆或卡死，其实，
• SDL 窗口尺寸未适配。画面超出屏幕，

FFmpeg 解复用整体流程概览

# 打开媒体文件
avformat_open_input
# 探测流信息
avformat_find_stream_info
# 遍历流并获取索引
for { …}
# 循环读取压缩数据包
while == 0) { …}

完整的解码 + 渲染流水线

开始
↓ . 打开视频文件 ✅
↓ . 查找流信息 ✅
↓ . 获得流索引 ✅
↓ . 查找视频解码器
↓ . 创建解码器上下文
↓ . 将流参数复制到解码器上下文
↓ . 打开解码器
↓ . 初始化 SDL
↓ . 读取数据包 ✅
↓ . 发送数据包到解码器
↓ . 接收解码帧
↓ . SDL 更新纹理并渲染
↓ . 冲刷解码器
↓ . 释放所有资源
结束

. 常用头文件

#include 
#include 
#include 
extern "C" {
#include "libavcodec/avcodec.h"
#include "libavutil/avutil.h"
#include "libavformat/avformat.h"
}
#include "SDL.h"

. 解复用关键函数详解

1. avformat_open_input

作用：打开本地文件或网络流，读取媒体容器头部并创建 FormatContext。

Pain Point：If you ignore return value and it’s negative,context will be NULL and later calls will segfault. Always check and call PrintErr.

FormatContext *demux_ctx = nullptr;int ret = avformat_open_input;if {
std:的观点是，cout < "avformat_open_input failed!" < std::endl;
    PrintErr;
    goto FAILED;
}

2. avformat_find_stream_info

作用：Lazily 探测每条流的详细参数。 为后续查找合适的解码器提供依据。

Pain Point：The function may return ERROR_EOF if file is truncated. In that case you still get partial stream info – check for warnings in log.

ret = avformat_find_stream_info;if {
std:的观点是，cout < "avformat_find_stream_info failed!" < std::endl;
    PrintErr;
    goto FAILED;
}

3. 获取视频/音频流索引

You can eir iterate manually or use newer helper API.

// 手动遍历
int video_index = -1。audio_index = -1;for {
CodecParameters *par = demux_ctx->streams->codecpar;if video_index = i;else if audio_index = i;老实说，}
// 新 API
video_index = av_find_best_stream(demux_ctx。MEDIA_TYPE_VIDEO,-1,-1,NULL,0);audio_index = av_find_best_stream(demux_ctx。MEDIA_TYPE_AUDIO,-1,-1,NULL,0);

Pain Point：If you forget to check that -1!= video_index。subsequent calls will crash because you’ll access an invalid stream.

4. av_read_frame – 读取压缩数据包

This is core of demuxing – it pulls one packet from container.

Packet *pkt = av_packet_alloc;其实，while {
ret = av_read_frame;if break，// 正常结束
if { // 错误处理
PrintErr;break，}
if {
// 视频包交给后面的解码环节处理
// ...
}
av_packet_unref;// 必须释放内部缓冲区
}
av_packet_free;

. 编码/播放完整流程细化

查找并打开视频解码器

// 得到 codec_id 并寻找对应的 decoder
CodecID codec_id = demux_ctx->streams->codecpar->codec_id;const Codec *decoder = avcodec_find_decoder;if { /* 错误处理 */ }
CodecContext *dec_ctx = avcodec_alloc_context3;if { /* 错误处理 */ }
// 把流参数拷贝进 decoder context
ret = avcodec_parameters_to_context(dec_ctx,demux_ctx->streams->codecpar);话说回来，if { /* 错误处理 */ }
ret = avcodec_open2;if { /* 错误处理 */ }

SDL 初始化与窗口尺寸自适应

SDL_Init;int screen_w=0,screen_h=0;其实，SDL_DisplayMode dm;if ) {
screen_w = dm.w;screen_h = dm.h;
}
int video_w = dec_ctx->width;怎么说呢，int video_h = dec_ctx->height;// 按比例缩放至不超过屏幕尺寸
double aspect = video_w / video_h;if {
video_w = screen_w;video_h = static_cast;}
if {
video_h = screen_h;video_w = static_cast;}
SDL_Window *win = SDL_CreateWindow("FFmpeg + SDL 播放"。SDL_WINDOWPOS_CENTERED,SDL_WINDOWPOS_CENTERED,video_w,video_h,0);SDL_Renderer *rend = SDL_CreateRenderer(win,-1。SDL_RENDERER_ACCELERATED|SDL_RENDERER_PRESENTVSYNC);SDL_Texture *tex = SDL_CreateTexture(rend,SDL_PIXELFORMAT_IYUV。SDL_TEXTUREACCESS_STREAMING,dec_ctx->width,dec_ctx->height);SDL_Rect rect={0,0,video_w,video_h};

至于主循环，读取‑发送‑接收‑渲染

Packet *pkt = av_packet_alloc;其实，Frame *frame = av_frame_alloc;while )==0){
if{ // 跳过非视频包
av_packet_unref;不过，continue，}
ret=avcodec_send_packet;// 把压缩包喂给 decoder
av_packet_unref;// 可立即归还
while )==0){
// 更新纹理并渲染到窗口
SDL_UpdateYUVTexture(tex,NULL,frame->data。frame->linesize,frame->data,frame->linesize,frame->data,frame->linesize);SDL_RenderClear;SDL_RenderCopy;SDL_RenderPresent;// 简单帧率控制
double fps = av_q2d;int delay_ms= static_cast;SDL_Delay，}
}
// 冲刷剩余帧
avcodec_send_packet;while==0){
// 同上渲染剩余帧...
}
// 清理资源
av_packet_free;av_frame_free;avcodec_free_context;avformat_close_input);SDL_DestroyTexture;SDL_DestroyRenderer;SDL_DestroyWindow;SDL_Quit，

. 常见坑点与调试技巧 🚀

• Error Code 忽视： -22。-541478725,等等。使用 a vstrerror  *一定*.
• Pkt 未初始化或忘记 unref： A memory leak or “Invalid argument” on next read.
• Sdl Texture 格式不匹配： IYUV/YUV420P 与源帧格式不一致会出现彩条。确保使用 IYUV 而且 frame 为 YUV420P。
• Sdl 窗口尺寸计算错误： Sdl 会把纹理拉伸至窗口大小。所以一定要先算好显示矩形 rect，否则画面被裁剪或变形。
• A/V 同步失效： If you rely only on SdlDelay,audio will drift. 在实际项目中请使用音频时钟同步或 libswresample 做重采样。
• #include 顺序导致链接错误：必须把所有 FFmpeg C 头文件放在 #extern "C".
• #define main 为 Windows 项目做兼容：在使用 SDL 时一定要把源码文件命名为 Main.cpp或者 添加#undef main .
.