FFMPEG源码之函数讲解

---

av_find_best_stream

av_find_best_stream函数是FFmpeg库中用于查找最佳匹配的媒体流的函数。它的详细用法如下：

函数原型：

int av_find_best_stream(AVFormatContext *ic, enum AVMediaType type, int wanted_stream_nb, int related_stream, AVCodec **decoder_ret, int flags);

参数说明：

• ic：AVFormatContext指针，表示输入的媒体文件上下文。
• type：要查找的媒体流类型，可以是音频流、视频流或字幕流等。
• wanted_stream_nb：期望的媒体流索引号，可以是特定的索引号，也可以是AV_NOPTS_VALUE（-1）表示任意流。
• related_stream：前一个相关流的索引号，如果没有前一个相关流，则传入-1。
• decoder_ret：返回解码器指针。
• flags：查找最佳流的标志位，默认为0。
• 返回值：
  找到的最佳匹配媒体流的索引号，如果找不到则返回AVERROR_STREAM_NOT_FOUND。

下面是一个使用av_find_best_stream函数的简单示例代码，它演示了如何使用该函数来查找最佳的视频流进行处理：

#include <libavformat/avformat.h>

int main() {
    AVFormatContext *formatContext = NULL;
    int videoStreamIndex = -1;
    AVCodec *videoCodec = NULL;
    
    // 打开媒体文件
    avformat_open_input(&formatContext, "input.mp4", NULL, NULL);
    
    // 查找最佳视频流
    videoStreamIndex = av_find_best_stream(formatContext, AVMEDIA_TYPE_VIDEO, -1, -1, &videoCodec, 0);
    if (videoStreamIndex >= 0) {
        AVStream *videoStream = formatContext->streams[videoStreamIndex];
        // 获取视频流的参数信息
        AVCodecParameters *videoCodecParameters = videoStream->codecpar;
        
        // 打印视频流的分辨率和编码方式
        printf("Resolution: %dx%d\n", videoCodecParameters->width, videoCodecParameters->height);
        printf("Codec: %s\n", videoCodec->name);
        
        // 进一步处理视频流
        // ...
    }
    
    // 关闭媒体文件
    avformat_close_input(&formatContext);
    
    return 0;
}

上述代码中，首先使用avformat_open_input函数打开了名为"input.mp4"的媒体文件，并通过av_find_best_stream函数查找最佳的视频流。如果找到了最佳视频流，它会获取视频流的参数信息，如分辨率和编码方式，并打印出来。你可以根据实际需要进一步处理视频流。
需要注意的是，在实际使用中，你需要将代码补充完整，包括错误处理、内存释放等。此示例仅为了演示av_find_best_stream函数的基本用法。确保在使用FFmpeg库的其他函数之前正确初始化库，并在使用完毕后进行释放资源的操作。

av_find_best_stream函数在视频处理和媒体播放等领域有广泛的应用。以下是一些它的相关应用：

• 媒体播放器：在媒体播放器中，可以使用av_find_best_stream函数来查找并选择最佳的音频流、视频流或字幕流进行播放。通过选择最佳流，可以确保播放器能够正确解码和显示媒体内容。
• 媒体转码：在进行媒体转码时，通常需要选择适合转码需求的媒体流进行处理。av_find_best_stream函数可以快速找到最佳匹配的媒体流，方便进行后续的转码操作。
• 视频编辑：在视频编辑应用中，av_find_best_stream函数可用于选择最佳的视频流进行剪辑、合并、特效处理等操作。通过选取最佳视频流，确保编辑结果的质量和兼容性。
• 直播流媒体处理：在直播流媒体应用中，av_find_best_stream函数可以用于选择最佳的媒体流，比如选择最佳的视频流进行直播推流或选择最佳的音频流进行音频处理。
• 媒体信息提取：av_find_best_stream函数还可以用于媒体分析和信息提取。通过查找最佳的媒体流，可以获取媒体流的相关参数，比如分辨率、编码方式、帧率等信息。

---

av_dump_format

av_dump_format是FFmpeg库中的函数，用于将输入或输出格式的详细信息打印到指定的文件中。

定义：av_dump_format函数的定义如下所示：

void av_dump_format(AVFormatContext *ctx, int index, const char *url, int is_output);

参数：

• AVFormatContext *ctx：输入或输出的AVFormatContext上下文。
• int index：流的索引，指定为-1时将打印所有流的信息。
• const char *url：输入或输出的URL。
• int is_output：指定是输入（0）还是输出（非零）。

操作详解： av_dump_format函数用于打印输入或输出格式的详细信息，包括流的信息、封装格式信息、流的时长、帧率等。
要使用av_dump_format函数，需要按照以下步骤进行操作：

• 打开输入或输出文件，获取相应的AVFormatContext上下文。
• 调用av_dump_format函数，以及传递上述参数。
• 如果需要将打印信息保存到文件，可以通过重定向stdout到文件来实现，或者使用av_log_set_callback函数设置自定义的日志回调函数。

示例代码如下所示：

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

int main(int argc, char *argv[]) {
    AVFormatContext *formatContext = NULL;
    
    avformat_open_input(&formatContext, argv[1], NULL, NULL);
    avformat_find_stream_info(formatContext, NULL);
    
    av_dump_format(formatContext, 0, argv[1], 0);
    
    avformat_close_input(&formatContext);
    
    return 0;
}

---

avformat_new_stream

avformat_new_stream是FFmpeg库中的函数，用于创建一个新的AVStream流并将其添加到AVFormatContext上下文中。

定义：avformat_new_stream函数的定义如下所示：

AVStream *avformat_new_stream(AVFormatContext *s, const AVCodec *c);

参数：

• AVFormatContext *s：要添加新流的AVFormatContext上下文。
• const AVCodec *c：流的编码器，用于设置流的编码信息。

操作详解： avformat_new_stream函数用于创建一个新的AVStream流，并将其添加到AVFormatContext上下文中。这个函数通常在编码器初始化之后调用。
要使用avformat_new_stream函数，需要按照以下步骤进行操作：

• 分配和初始化一个新的AVStream结构体。
• 为新的AVStream设置它的索引（index），通常是上下文（AVFormatContext）中现有流的数量。
• 设置流的编码格式（codec）和编码器（codecpar）。
• 将新的AVStream添加到上下文的streams数组中。
• 返回新的AVStream指针，供后续操作使用。

示例代码如下所示：

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

int main() {
    AVFormatContext *formatContext;
    AVCodec *codec;
    AVStream *stream;
    
    // 初始化格式上下文
    avformat_alloc_output_context2(&formatContext, NULL, NULL, "output.mp4");
    
    // 查找音频编码器
    codec = avcodec_find_encoder(AV_CODEC_ID_AAC);
    
    // 创建新的音频流
    stream = avformat_new_stream(formatContext, codec);
    if (!stream) {
        fprintf(stderr, "Failed to create new stream.\n");
        return -1;
    }
    
    // 设置流的编码器参数
    AVCodecParameters *codecpar = stream->codecpar;
    codecpar->codec_type = AVMEDIA_TYPE_AUDIO;
    codecpar->codec_id = codec->id;
    
    // 将新的流添加到格式上下文中
    avio_open(&formatContext->pb, "output.mp4", AVIO_FLAG_WRITE);
    avformat_write_header(formatContext, NULL);
    avformat_write_trailer(formatContext);
    avio_close(formatContext->pb);
    
    avformat_free_context(formatContext);
    
    return 0;
}