C++调用FFmpeg解码视频全流程详解

1. 项目概述

作为一名长期奋战在音视频开发一线的老码农，今天我想和大家聊聊C++调用FFmpeg解码视频的那些事儿。这活儿看着简单，但实际踩过的坑比我家楼下早点铺的油条还多。FFmpeg这个开源库就像一把瑞士军刀，功能强大到能让你怀疑人生，但它的API设计却经常让人想砸键盘。

记得我第一次接触FFmpeg时，光是理解那一堆AV开头的结构体就差点让我当场退役。AVFormatContext、AVCodecContext、AVPacket、AVFrame...这些名词排着队来折磨你的脑细胞。更让人崩溃的是，不同版本间的API变动比女朋友的心情变化还快，今天能跑的代码明天可能就编译不过了。

2. 核心概念解析

2.1 FFmpeg架构理解

FFmpeg的解码流程可以类比为一条食品加工流水线：

1. 原料采购（AVFormatContext）：负责从文件或网络获取原始数据，就像去超市采购食材。
2. 初步处理（AVPacket）：获取的压缩数据包，相当于买回来的带包装食品。
3. 精细加工（AVCodecContext）：解码器上下文，就是厨房里的各种厨具。
4. 成品输出（AVFrame）：解码后的原始帧数据，就像做好的菜肴。

2.2 关键数据结构

cpp复制// 文件格式上下文，包含文件的全局信息
AVFormatContext *pFormatCtx;

// 编码器参数，描述视频流的基本属性
AVCodecParameters *pCodecPar;

// 编码器上下文，控制解码过程
AVCodecContext *pCodecCtx;

// 压缩数据包
AVPacket *packet;

// 解码后的原始帧
AVFrame *frame;

3. 完整解码流程实现

3.1 环境准备

首先需要安装FFmpeg开发库。在Ubuntu上可以这样安装：

bash复制sudo apt-get install libavcodec-dev libavformat-dev libswscale-dev

Windows用户建议使用vcpkg进行安装：

powershell复制vcpkg install ffmpeg:x64-windows

3.2 基础解码代码实现

下面是一个完整的视频解码示例，我加上了详细的注释：

cpp复制#include <iostream>

extern "C" {
#include <libavcodec/avcodec.h>
#include <libavformat/avformat.h>
#include <libswscale/swscale.h>
}

int main(int argc, char* argv[]) {
    if (argc < 2) {
        std::cerr << "Usage: " << argv[0] << " <input_file>" << std::endl;
        return -1;
    }

    const char* filename = argv[1];
    
    // 1. 初始化格式上下文
    AVFormatContext* pFormatCtx = nullptr;
    if (avformat_open_inpu