#include <libavformat/avformat.h>

/**
 * Allocate an AVFormatContext.
 * avformat_free_context() can be used to free the context and everything
 * allocated by the framework within it.
 */
AVFormatContext *avformat_alloc_context(void);

## AVFormatContext：它是FFMPEG解封装（flv，mp4，rmvb，avi）功能的结构体， 	

其中比较重要的几个如下解释：

typedef struct AVFormatContext {
    const AVClass *av_class;   // 一个类，用于保存指向父对象的链接，用于日志记录
    struct AVInputFormat *iformat;  // 用于指定输入文件的格式以及文件读取的操作函数
    struct AVOutputFormat *oformat; // 用于指定输出文件的格式以及文件写入的操作函数
    void *priv_data;            // 指向 AVFormatContext（容器上下文）的私有数据
    AVIOContext *pb;            // 用于读取和写入媒体数据的 I/O 上下文
    int nb_streams;             // 流的数量，包括音频、视频、字幕等
    AVStream **streams;         // 指向 AVStream 结构体的指针，用于存储所有流的信息
    char *filename;             // 用于存储文件名的字符串
    int64_t start_time, duration;// 媒体文件的起始时间戳和持续时间
    int64_t bit_rate;           // 比特率，以 bit/s 计算
    uint8_t *buffer;            // 用于暂存数据的缓冲区
    int buffer_size;            // 缓冲区的大小
} AVFormatContext;


AVFormatContext 结构体的各个成员变量的作用详见以下介绍。

成员变量介绍

AVClass *av_class: 一个类，用于保存指向父对象的链接，用于日志记录；
AVClass是FFmpeg中libavutil库中的一个结构体，用于在FFmpeg中实现类及其对象的日志和调试功能。AVClass提供了一种标准的方式来管理类及其对象，在不同的库和插件之间提供了统一的日志记录和调试接口。

AVInputFormat *iformat：用于指定输入文件的格式以及文件读取的操作函数；
AVOutputFormat *oformat: 用于指定输出文件的格式以及文件写入的操作函数；

void *priv_data: 指向 AVFormatContext（容器上下文）的私有数据；
priv_data成员可以用于存储和传递特定协议下使用的私有数据，常见的使用场景是实现自定义输入或输出协议。

AVIOContext *pb：用于读取和写入媒体数据的 I/O 上下文；
AVIOContext 是libavformat库中一个表示访问媒体文件的I/O环境的结构体。它封装了对媒体文件的读取和写入操作，提供了和具体I/O操作系统相关的操作的抽象接口，实现了独立于实际操作系统的媒体文件访问接口。

int nb_streams: 流的数量，包括音频、视频、字幕等；
AVStream **streams：指向 AVStream 结构体的指针，用于存储所有流的信息；
AVStream是FFmpeg中libavformat库中的一个数据结构，用于表示媒体文件中的一个音频或视频流。在FFmpeg中，一个媒体文件通常包含多个音视频流，每个流对应着媒体文件中的一个轨道。AVStream通过存储音视频流的各种属性信息，方便解码和编码，对于多媒体处理和视频编辑有着至关重要的作用。
AVStream包含了一个媒体流的所有基本信息，如类型、编解码器、时间戳、时长、帧率、码率等等。常用的成员变量有：
char *filename: 用于存储文件名的字符串；

int64_t start_time: 媒体文件的起始时间戳；
int64_t duration: 媒体文件的持续时间；
int64_t bit_rate: 比特率，以 bit/s 计算；
uint8_t *buffer: 用于暂存数据的缓冲区；
int buffer_size: 缓冲区的大小。

avformat_open_input() 函数是用于打开媒体文件并获取媒体文件信息的函数，该函数定义在libavformat/avformat.h中。


该函数的参数含义如下：

ps：AVFormatContext结构体的指针。该参数用于存储打开的媒体文件的信息。当该函数成功返回时，AVFormatContext结构体中将存储媒体文件的相关信息。
url：要打开的媒体文件的URL。可以是本地文件路径，也可以是HTTP URL或其他协议的URL。
fmt：AVInputFormat结构体的指针，用于指定媒体文件的格式。如果该参数为NULL，则根据文件扩展名自动选择输入格式。
options：AVDictionary结构体的指针，用于传递打开媒体文件时的选项。



/**
 * Open an input stream and read the header. The codecs are not opened.
 * The stream must be closed with avformat_close_input().
 *
 * @param ps       Pointer to user-supplied AVFormatContext (allocated by
 *                 avformat_alloc_context). May be a pointer to NULL, in
 *                 which case an AVFormatContext is allocated by this
 *                 function and written into ps.
 *                 Note that a user-supplied AVFormatContext will be freed
 *                 on failure.
 * @param url      URL of the stream to open.
 * @param fmt      If non-NULL, this parameter forces a specific input format.
 *                 Otherwise the format is autodetected.
 * @param options  A dictionary filled with AVFormatContext and demuxer-private
 *                 options.
 *                 On return this parameter will be destroyed and replaced with
 *                 a dict containing options that were not found. May be NULL.
 *
 * @return 0 on success, a negative AVERROR on failure.
 *
 * @note If you want to use custom IO, preallocate the format context and set its pb field.
 */
int avformat_open_input(AVFormatContext **ps, const char *url,
                        const AVInputFormat *fmt, AVDictionary **options);

/**
 * Seek to timestamp ts.
 * Seeking will be done so that the point from which all active streams
 * can be presented successfully will be closest to ts and within min/max_ts.
 * Active streams are all streams that have AVStream.discard < AVDISCARD_ALL.
 *
 * If flags contain AVSEEK_FLAG_BYTE, then all timestamps are in bytes and
 * are the file position (this may not be supported by all demuxers).
 * If flags contain AVSEEK_FLAG_FRAME, then all timestamps are in frames
 * in the stream with stream_index (this may not be supported by all demuxers).
 * Otherwise all timestamps are in units of the stream selected by stream_index
 * or if stream_index is -1, in AV_TIME_BASE units.
 * If flags contain AVSEEK_FLAG_ANY, then non-keyframes are treated as
 * keyframes (this may not be supported by all demuxers).
 * If flags contain AVSEEK_FLAG_BACKWARD, it is ignored.
 *
 * @param s            media file handle
 * @param stream_index index of the stream which is used as time base reference
 * @param min_ts       smallest acceptable timestamp
 * @param ts           target timestamp
 * @param max_ts       largest acceptable timestamp
 * @param flags        flags
 * @return >=0 on success, error code otherwise
 *
 * @note This is part of the new seek API which is still under construction.
 */
int avformat_seek_file(AVFormatContext *s, int stream_index, int64_t min_ts, int64_t ts, int64_t max_ts, int flags);

参数解释如下：

1，AVFormatContext *s，已经打开的容器示例。

2，int stream_index，流索引，但是只有在 flags 包含 AVSEEK_FLAG_FRAME 的时候才是 设置某个流的读取位置。其他情况都只是把这个流的 time_base （时间基）作为参考。

3，int64_t min_ts，跳转到的最小的时间，但是这个变量不一定是时间单位，也有可能是字节单位，也可能是帧数单位（第几帧）。

4，int64_t ts，要跳转到的读取位置，单位同上。

5，int64_t max_ts，跳转到的最大的时间，单位同上，通常填 INT64_MAX 即可。

6，int flags，跳转的方式，有 4 个 flags，如下：

AVSEEK_FLAG_BYTE，按字节大小进行跳转。
AVSEEK_FLAG_FRAME，按帧数大小进行跳转。
AVSEEK_FLAG_ANY，可以跳转到非关键帧的读取位置，但是解码会出现马赛克。
AVSEEK_FLAG_BACKWARD，往 ts 的后面找关键帧，默认是往 ts 的前面找关键帧。
avformat_seek_file() 函数默认是把文件的读取位置，设置到离 ts 参数最近的关键帧的地方。

而且默认情况，是容器里面所有流的读取位置都会被设置，包括 音频流，视频流，字幕流。

只要流的 discard 属性小于 AVDISCARD_ALL 就会被设置。

AVStream.discard < AVDISCARD_ALL
min_ts 跟 max_ts 变量有一些设置的技巧。

如果是快进的时候，min_ts 可以设置得比 当前位置 大一点，例如加 2。 而 max_ts 可以填 INT64_MAX

min_ts = 当前位置 + 2
max_ts = INT64_MAX
+2 是为了防止某些情况，avformat_seek_file() 会把读取位置往后挪一点。

如果是后退的时候，min_ts 可以填 INT64_MIN，max_ts 可以设置得比 当前位置 小一点，例如减 2。

min_ts = INT64_MIN
max_ts = 当前位置 - 2
-2 是为了防止某些情况，avformat_seek_file() 会把读取位置往前挪一点。

当 flags 为 0 的时候，默认情况，是按时间来 seek 的，而时间基是根据 stream_index 来确定的。

如果 stream_index 为 -1 ，那 ts 的时间基就是 AV_TIME_BASE，

如果stream_index 不等于 -1 ，那 ts 的时间基就是 stream_index 对应的流的时间基。

这种情况，avformat_seek_file() 会导致容器里面所有流的读取位置都发生跳转，包括音频流，视频流，字幕流。

当 flags 包含 AVSEEK_FLAG_BYTE，ts 参数就是字节大小，代表 avformat_seek_file() 会把读取位置设置到第几个字节。用 av_read_frame() 读出来的 pkt 里面有一个字段 pos，代表当前读取的字节位置。可以用pkt->pos 辅助设置 ts 参数，

AVSEEK_FLAG_BYTE 是否是对所有流都生效，我后面测试一下再补充。

当 flags 包含 AVSEEK_FLAG_FRAME，ts 参数就是帧数大小，代表 avformat_seek_file() 会把读取位置设置到第几帧。这时候 stream_index 可以指定只设置某个流的读取位置，如果 stream_index 为 -1 ，代表设置所有的流。

当 flags 包含 AVSEEK_FLAG_ANY，那就代表 seek 可以跳转到非关键帧的位置，但是非关键帧解码会出现马赛克。如果不设置 AVSEEK_FLAG_ANY， 默认是跳转到离 ts 最近的关键帧的位置的。

当 flags 包含 AVSEEK_FLAG_BACKWARD，代表 avformat_seek_file() 在查找里 ts 最近的关键帧的时候，会往 ts 的后面找，默认是往 ts 的前面找关键帧。

提醒：AVSEEK_FLAG_BYTE ，AVSEEK_FLAG_FRAME，AVSEEK_FLAG_ANY 这 3 种方式，有些封装格式是不支持的。

下面通过一个例子来演示 avformat_seek_file() 函数的用法。
————————————————

                            版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
                        
原文链接：https://blog.csdn.net/u012117034/article/details/127760798

可以看到，跳转之后，后面 av_read_frame() 读取到的 AVPacket 的 pts 跟 pos 都有很大的偏移了。

avformat_seek_file() 函数介绍完毕。

扩展知识：avformat_seek_file() 对应的旧版函数是 av_seek_frame()
————————————————

                            版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
                        
原文链接：https://blog.csdn.net/u012117034/article/details/127760798

/**
 * Find a registered decoder with a matching codec ID.
 *
 * @param id AVCodecID of the requested decoder
 * @return A decoder if one was found, NULL otherwise.
 */
const AVCodec *avcodec_find_decoder(enum AVCodecID id);

详情请参考 enum AVCodecID，这个enum AVCodecID 太大了，这里写不下，用的时候要具体查看，我们举例说明一下，就好

    const AVCodec *codec;
    codec = avcodec_find_decoder(AV_CODEC_ID_AAC);


    const AVCodec *codec;
    codec = avcodec_find_decoder(AV_CODEC_ID_H264);

但是这里有一个问题，就是我们一般在解析一个文件的时候，并不知道这个文件的音频和视频用的什么编码，也就不知道用什么解码器解码比较好，因此，这里一种通用的写法是使用如下的api从得到流中 最合适的

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