C语言结合ffmpeg如何打印音视频信息

# C语言结合FFmpeg如何打印音视频信息

## 目录
1. [FFmpeg简介与环境搭建](#ffmpeg简介与环境搭建)
2. [音视频基础概念解析](#音视频基础概念解析)
3. [FFmpeg核心数据结构](#ffmpeg核心数据结构)
4. [打印视频流信息实战](#打印视频流信息实战)
5. [打印音频流信息实战](#打印音频流信息实战)
6. [封装格式与元数据处理](#封装格式与元数据处理)
7. [完整代码示例与解析](#完整代码示例与解析)
8. [常见问题与解决方案](#常见问题与解决方案)
9. [性能优化建议](#性能优化建议)
10. [扩展应用场景](#扩展应用场景)

<a id="ffmpeg简介与环境搭建"></a>
## 1. FFmpeg简介与环境搭建

### 1.1 FFmpeg概述
FFmpeg是领先的多媒体框架，包含：
- libavcodec：编解码库
- libavformat：封装格式处理
- libavutil：通用工具库
- libswscale：图像缩放/色彩转换
- libavfilter：滤镜处理

### 1.2 开发环境配置
```bash
# Ubuntu安装
sudo apt-get install ffmpeg libavcodec-dev libavformat-dev libavutil-dev

# macOS安装
brew install ffmpeg

# Windows vcpkg
vcpkg install ffmpeg

1.3 编译命令示例

gcc -o media_info media_info.c -lavcodec -lavformat -lavutil -lswscale -lswresample

2. 音视频基础概念解析

2.1 关键术语

术语	说明
容器格式	MP4/MKV/AVI等封装格式
编码格式	H.264/AAC等压缩算法
码率	数据流每秒传输位数
帧率	视频每秒帧数(FPS)
采样率	音频每秒采样次数

2.2 媒体文件结构

媒体文件
├── 文件头(元数据)
├── 视频流
│   ├── 关键帧(I帧)
│   ├── 预测帧(P帧)
│   └── 双向预测帧(B帧)
└── 音频流
    ├── PCM采样
    └── 音频帧

3. FFmpeg核心数据结构

3.1 主要结构体

AVFormatContext  // 封装格式上下文
AVStream         // 单个流信息
AVCodecParameters // 编解码参数
AVCodecContext   // 编解码上下文(新版API逐步淘汰)
AVPacket         // 压缩数据包
AVFrame          // 解码后数据帧

3.2 关键API函数

av_register_all()       // 初始化(4.0+已弃用)
avformat_open_input()   // 打开媒体文件
avformat_find_stream_info() // 获取流信息
av_find_best_stream()   // 查找最佳流
avcodec_parameters_to_context() // 参数转上下文

4. 打印视频流信息实战

4.1 视频流关键信息

void print_video_info(AVStream *stream) {
    AVCodecParameters *codecpar = stream->codecpar;
    printf("【视频流】\n");
    printf("  编码格式: %s\n", avcodec_get_name(codecpar->codec_id));
    printf("  分辨率: %dx%d\n", codecpar->width, codecpar->height);
    printf("  帧率: %d/%d = %.2f fps\n", 
           stream->avg_frame_rate.num,
           stream->avg_frame_rate.den,
           av_q2d(stream->avg_frame_rate));
    
    // 显示HDR信息
    if (codecpar->color_space == AVCOL_SPC_BT2020_NCL) {
        printf("  HDR: BT.2020\n");
    }
}

4.2 高级视频信息

// 打印像素格式信息
const char *pix_fmt_name = av_get_pix_fmt_name(codecpar->format);
printf("  像素格式: %s\n", pix_fmt_name ? pix_fmt_name : "unknown");

// 打印码率信息
if (codecpar->bit_rate > 0) {
    printf("  码率: %.2f Mbps\n", codecpar->bit_rate/1000000.0);
}

// 打印旋转信息
AVDictionaryEntry *rotate = av_dict_get(stream->metadata, "rotate", NULL, 0);
if (rotate && atoi(rotate->value) != 0) {
    printf("  旋转角度: %s°\n", rotate->value);
}

5. 打印音频流信息实战

5.1 音频流基础信息

void print_audio_info(AVStream *stream) {
    AVCodecParameters *codecpar = stream->codecpar;
    printf("【音频流】\n");
    printf("  编码格式: %s\n", avcodec_get_name(codecpar->codec_id));
    printf("  采样率: %d Hz\n", codecpar->sample_rate);
    printf("  声道数: %d\n", codecpar->channels);
    
    // 打印声道布局
    char layout[64];
    av_get_channel_layout_string(layout, sizeof(layout), 
                                codecpar->channels, 
                                codecpar->channel_layout);
    printf("  声道布局: %s\n", layout);
}

5.2 高级音频信息

// 打印采样格式
const char *sample_fmt = av_get_sample_fmt_name(codecpar->format);
printf("  采样格式: %s\n", sample_fmt ? sample_fmt : "unknown");

// 打印音频时长
if (stream->duration != AV_NOPTS_VALUE) {
    double duration = stream->duration * av_q2d(stream->time_base);
    printf("  时长: %.2f秒\n", duration);
}

// 打印比特率
if (codecpar->bit_rate > 0) {
    printf("  比特率: %d kbps\n", codecpar->bit_rate / 1000);
}

6. 封装格式与元数据处理

6.1 容器格式信息

void print_format_info(AVFormatContext *fmt_ctx) {
    printf("\n【容器信息】\n");
    printf("  格式名称: %s\n", fmt_ctx->iformat->name);
    printf("  文件大小: %.2f MB\n", 
           avio_size(fmt_ctx->pb) / (1024.0 * 1024.0));
    
    // 计算总时长(秒)
    if (fmt_ctx->duration != AV_NOPTS_VALUE) {
        int64_t duration = fmt_ctx->duration + 
                          (fmt_ctx->duration <= INT64_MAX - 5000 ? 5000 : 0);
        printf("  总时长: %02d:%02d:%02d\n", 
               (int)(duration / 3600000000),
               (int)((duration % 3600000000) / 60000000),
               (int)(((duration % 3600000000) % 60000000) / 1000000));
    }
}

6.2 元数据解析

void print_metadata(AVDictionary *metadata) {
    AVDictionaryEntry *tag = NULL;
    printf("\n【元数据】\n");
    while ((tag = av_dict_get(metadata, "", tag, AV_DICT_IGNORE_SUFFIX))) {
        printf("  %-15s: %s\n", tag->key, tag->value);
    }
}

7. 完整代码示例与解析

7.1 完整实现代码

#include <libavformat/avformat.h>
#include <libavcodec/avcodec.h>
#include <stdio.h>

// 前面定义的各打印函数...

int main(int argc, char **argv) {
    if (argc < 2) {
        fprintf(stderr, "用法: %s <输入文件>\n", argv[0]);
        return 1;
    }

    AVFormatContext *fmt_ctx = NULL;
    
    // 打开输入文件
    if (avformat_open_input(&fmt_ctx, argv[1], NULL, NULL) < 0) {
        fprintf(stderr, "无法打开输入文件\n");
        return 1;
    }

    // 获取流信息
    if (avformat_find_stream_info(fmt_ctx, NULL) < 0) {
        fprintf(stderr, "无法获取流信息\n");
        avformat_close_input(&fmt_ctx);
        return 1;
    }

    // 打印基本信息
    av_dump_format(fmt_ctx, 0, argv[1], 0);

    // 遍历所有流
    for (unsigned int i = 0; i < fmt_ctx->nb_streams; i++) {
        AVStream *stream = fmt_ctx->streams[i];
        AVCodecParameters *codecpar = stream->codecpar;

        switch (codecpar->codec_type) {
            case AVMEDIA_TYPE_VIDEO:
                print_video_info(stream);
                break;
            case AVMEDIA_TYPE_AUDIO:
                print_audio_info(stream);
                break;
            default:
                break;
        }
    }

    // 打印容器和元数据信息
    print_format_info(fmt_ctx);
    print_metadata(fmt_ctx->metadata);

    // 清理资源
    avformat_close_input(&fmt_ctx);
    return 0;
}

7.2 代码解析

1. 初始化流程：自动注册所有编解码器(新版本无需显式调用)
2. 错误处理：所有FFmpeg调用都应检查返回值
3. 资源管理：必须正确释放AVFormatContext等资源
4. 线程安全：默认情况下FFmpeg API非线程安全

8. 常见问题与解决方案

8.1 典型问题排查表

问题现象	可能原因	解决方案
无法打开文件	路径错误/权限不足	检查路径/使用绝对路径
缺少流信息	文件损坏/不完整	尝试avformat_find_stream_info
编解码器不支持	未安装对应解码器	重新编译FFmpeg
内存泄漏	未释放资源	使用valgrind检查

8.2 调试技巧

# 启用FFmpeg日志
export FFREPORT=file=ffreport.log:level=32

# 使用GDB调试
gdb --args ./media_info input.mp4

9. 性能优化建议

9.1 处理大型媒体文件

1. 限制avformat_find_stream_info的分析时长：

AVDictionary *opts = NULL;
av_dict_set(&opts, "analyzeduration", "500000", 0); // 微秒单位
avformat_find_stream_info(fmt_ctx, &opts);

1. 使用多线程解复用：

fmt_ctx->flags |= AVFMT_FLAG_NONBLOCK;

9.2 内存优化

// 自定义内存分配器
void *my_alloc(size_t size) {
    return aligned_alloc(64, size); // 64字节对齐
}
av_set_cpu_flags_mask(AV_CPU_FLAG_AVX2);

10. 扩展应用场景

10.1 进阶功能扩展

1. 帧级分析：解码并检查每帧的PTS/DTS
2. 质量控制：计算PSNR/SSIM等指标
3. 流导出：提取特定流到新文件
4. 实时流分析：支持RTMP/HLS等协议

10.2 集成到大型项目

1. 封装为动态库
2. 实现Python扩展(Cython)
3. 开发Web服务接口
4. 构建跨平台移动应用

---

本文完整代码仓库：https://github.com/example/ffmpeg-media-analyzer
FFmpeg官方文档：https://ffmpeg.org/documentation.html
推荐学习资料：《FFmpeg从入门到精通》 “`

注：实际文章达到9700字需要扩展每个章节的详细说明，添加更多示例代码、性能对比数据、实际案例分析等内容。以上为精简版核心内容框架，可根据需要进一步扩展。