从零到一学FFmpeg：avformat_alloc_output_context2 函数详析与实战

文章目录

前言
一、函数原型
二、功能描述
三、使用场景
[四、AVFormatContext 结构体](#四、AVFormatContext 结构体)
五、代码实例

前言

avformat_alloc_output_context2 是FFmpeg库中的一个函数，用于为输出多媒体文件初始化一个AVFormatContext结构体。这个函数在开始输出音频、视频数据到文件之前被调用，它是多媒体文件操作过程中的一个关键步骤。

提示：以下是本篇文章正文内容，下面案例可供参考

一、函数原型

bash 复制代码

int avformat_alloc_output_context2(
    AVFormatContext **ctx, 
    const AVOutputFormat *oformat,
    const char *format_name,
    const char *filename);

参数说明

1、**AVFormatContext **ctx: 这是一个输出上下文指针的指针。
函数会为输出操作分配并初始化一个AVFormatContext结构，并将指针地址赋给ctx。
在调用此函数前，应将ctx初始化为NULL。

2、const AVOutputFormat *oformat: 指向输出格式的指针。
这个参数可以是NULL，此时函数会根据format_name或filename的扩展名自动推断输出格式。
如果不为NULL，你应该提供一个特定的输出格式
（例如，对于MP4文件，可能是av_guess_format("mp4", NULL, NULL)的结果），这允许你精确控制输出格式。

3、const char *format_name: 一个指定输出格式的字符串。
如果oformat为NULL且format_name非空，FFmpeg会尝试根据这个名字找到合适的输出格式。
例如，你可以传入"mp4"来指定输出为MP4格式。

4、const char *filename: 输出文件的名称。
这个参数主要用于根据文件扩展名自动生成输出格式（当oformat为NULL时）。
如果同时提供了format_name，则此参数主要用于信息提示，并帮助确定编码器等。

返回值

成功时返回0。
失败时返回一个负的错误代码（如AVERROR_NOENT、AVERROR_INVALIDDATA等），
具体可以通过av_strerror()函数转化为可读的错误信息

二、功能描述

分配与初始化 : 分配内存给AVFormatContext结构体并进行基本的初始化设置，准备用于输出多媒体流。
自动检测格式 : 如果未直接指定输出格式(oformat为NULL)，函数会根据提供的文件名或格式名称自动检测应使用的输出格式。
准备输出: 为后续的音频、视频流的封装和实际数据的写入做准备

三、使用场景

当你需要使用FFmpeg库编写程序以编码并输出音频、视频到文件时，这个函数是必须的初始化步骤。之后，你通常会继续使用其他FFmpeg函数添加音视频流、打开文件、写入头信息、发送编码好的数据包等。

请注意，使用完毕后，应该通过avio_closep(&ctx->pb)关闭IO上下文，并通过avformat_free_context(ctx)释放整个AVFormatContext结构体所占用的资源。

四、AVFormatContext 结构体

AVFormatContext是FFmpeg库中的一个核心结构体，它用于存储与多媒体容器格式相关的全局信息以及对输入输出操作的上下文管理。当你处理音频、视频文件或者流媒体时，无论是进行解复用（demuxing）还是复用（muxing），都会用到这个结构体。

结构体定义概述:

c 复制代码

typedef struct AVFormatContext {
    /* 基本信息 */
    AVClass *av_class;           // 对象的类信息，用于日志和运行时类型信息
    intiformat *iformat;         // 输入格式上下文，包含文件格式信息
    AVOutputFormat *oformat;     // 输出格式上下文，包含输出文件的格式信息

    /* 文件/网络IO相关 */
    AVIOContext *pb;             // 输入输出缓冲区上下文，处理底层的读写操作
    char *filename;              // 当前操作的文件名或URL

    /* 时间基相关 */
    AVRational pkt_timebase;     // 数据包时间基，用于时间戳转换
    int64_t start_time;          // 流开始的时间戳
    int64_t duration;            // 流的总时长，单位是AV_TIME_BASE时间单位

    /* 音视频流信息 */
    int nb_streams;              // 流的数量
    AVStream **streams;           // 指向AVStream结构体数组的指针，每个AVStream对应一个音视频流

    /* 其他控制选项 */
    int flags;                   // 格式上下文的标志，比如AVFMT_FLAG_GENPTS
    int probesize;               // 分析文件头时读取的数据量上限
    int max_analyze_duration;    // 最大分析时长，防止分析无限进行
    ...
    /* 更多字段，这里省略了众多用于控制和状态跟踪的高级选项 */
} AVFormatContext;

五、代码实例

avformat_alloc_output_context2 主要用于为输出多媒体文件或流创建并初始化一个AVFormatContext结构体实例，下面是一个使用该函数的代码示例，展示了如何准备输出上下文以便进行复用（即封装编码后的音视频数据到一个文件中）：

c 复制代码

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

int main() {
    // 初始化FFmpeg库
    av_register_all();
    avformat_network_init();

    const char *output_filename = "output.mp4"; // 输出文件名
    const char *format_name = NULL; // 可以指定输出格式名称，如果根据文件名能自动推断则无需指定
    AVFormatContext *output_format_ctx = NULL; // 输出格式上下文指针

    // 使用avformat_alloc_output_context2创建输出上下文
    int ret = avformat_alloc_output_context2(&output_format_ctx, NULL, format_name, output_filename);
    if (ret < 0) {
        printf("Could not create output context\n");
        return -1;
    }

    // 如果是根据文件名自动推断的输出格式，则可以从output_format_ctx->oformat中获取实际的输出格式信息
    if (!format_name) {
        printf("Automatically detected output format: %s\n", output_format_ctx->oformat->name);
    } else {
        // 如果手动指定了format_name，则此处可以进行额外的格式设置或验证
    }

    // 接下来通常需要添加音视频流到输出上下文中，配置流的相关参数，
    // 然后打开输出文件，并开始写入头部信息、编码数据等操作。

    // ...此处省略添加流、打开输出文件、写入数据等后续步骤...

    // 最终，记得清理资源
    if (output_format_ctx != NULL) {
        avio_close(output_format_ctx->pb);
        avformat_free_context(output_format_ctx);
    }

    return 0;
}