FFMPEG结构体分析：AVStream

注：写了一系列的结构体的分析的文章，在这里列一个列表：

FFMPEG结构体分析：AVFrame

FFMPEG结构体分析：AVFormatContext

FFMPEG结构体分析：AVCodecContext

FFMPEG结构体分析：AVIOContext

FFMPEG结构体分析：AVCodec

FFMPEG结构体分析：AVStream
FFMPEG结构体分析：AVPacket

FFMPEG有几个最重要的结构体，包含了解协议，解封装，解码操作，此前已经进行过分析：

FFMPEG中最关键的结构体之间的关系

在此不再详述，其中AVStream是存储每一个视频/音频流信息的结构体。本文将会分析一下该结构体里重要变量的含义和作用。

首先看一下结构体的定义（位于avformat.h文件中）：

[cpp] view plain copy

1. 
   
2. /** 
3.  * Stream structure. 
4.  * New fields can be added to the end with minor version bumps. 
5.  * Removal, reordering and changes to existing fields require a major 
6.  * version bump. 
7.  * sizeof(AVStream) must not be used outside libav*. 
8.  */  
9. typedef struct AVStream {  
10.     int index;    /**< stream index in AVFormatContext */  
11.     /** 
12.      * Format-specific stream ID. 
13.      * decoding: set by libavformat 
14.      * encoding: set by the user 
15.      */  
16.     int id;  
17.     AVCodecContext *codec; /**< codec context */  
18.     /** 
19.      * Real base framerate of the stream. 
20.      * This is the lowest framerate with which all timestamps can be 
21.      * represented accurately (it is the least common multiple of all 
22.      * framerates in the stream). Note, this value is just a guess! 
23.      * For example, if the time base is 1/90000 and all frames have either 
24.      * approximately 3600 or 1800 timer ticks, then r_frame_rate will be 50/1. 
25.      */  
26.     AVRational r_frame_rate;  
27.     void *priv_data;  
28.   
29.     /** 
30.      * encoding: pts generation when outputting stream 
31.      */  
32.     struct AVFrac pts;  
33.   
34.     /** 
35.      * This is the fundamental unit of time (in seconds) in terms 
36.      * of which frame timestamps are represented. For fixed-fps content, 
37.      * time base should be 1/framerate and timestamp increments should be 1. 
38.      * decoding: set by libavformat 
39.      * encoding: set by libavformat in av_write_header 
40.      */  
41.     AVRational time_base;  
42.   
43.     /** 
44.      * Decoding: pts of the first frame of the stream in presentation order, in stream time base. 
45.      * Only set this if you are absolutely 100% sure that the value you set 
46.      * it to really is the pts of the first frame. 
47.      * This may be undefined (AV_NOPTS_VALUE). 
48.      * @note The ASF header does NOT contain a correct start_time the ASF 
49.      * demuxer must NOT set this. 
50.      */  
51.     int64_t start_time;  
52.   
53.     /** 
54.      * Decoding: duration of the stream, in stream time base. 
55.      * If a source file does not specify a duration, but does specify 
56.      * a bitrate, this value will be estimated from bitrate and file size. 
57.      */  
58.     int64_t duration;  
59.   
60.     int64_t nb_frames;                 ///< number of frames in this stream if known or 0  
61.   
62.     int disposition; /**< AV_DISPOSITION_* bit field */  
63.   
64.     enum AVDiscard discard; ///< Selects which packets can be discarded at will and do not need to be demuxed.  
65.   
66.     /** 
67.      * sample aspect ratio (0 if unknown) 
68.      * - encoding: Set by user. 
69.      * - decoding: Set by libavformat. 
70.      */  
71.     AVRational sample_aspect_ratio;  
72.   
73.     AVDictionary *metadata;  
74.   
75.     /** 
76.      * Average framerate 
77.      */  
78.     AVRational avg_frame_rate;  
79.   
80.     /** 
81.      * For streams with AV_DISPOSITION_ATTACHED_PIC disposition, this packet 
82.      * will contain the attached picture. 
83.      * 
84.      * decoding: set by libavformat, must not be modified by the caller. 
85.      * encoding: unused 
86.      */  
87.     AVPacket attached_pic;  
88.   
89.     /***************************************************************** 
90.      * All fields below this line are not part of the public API. They 
91.      * may not be used outside of libavformat and can be changed and 
92.      * removed at will. 
93.      * New public fields should be added right above. 
94.      ***************************************************************** 
95.      */  
96.   
97.     /** 
98.      * Stream information used internally by av_find_stream_info() 
99.      */  
100. #define MAX_STD_TIMEBASES (60*12+5)  
101.     struct {  
102.         int64_t last_dts;  
103.         int64_t duration_gcd;  
104.         int duration_count;  
105.         double duration_error[2][2][MAX_STD_TIMEBASES];  
106.         int64_t codec_info_duration;  
107.         int nb_decoded_frames;  
108.         int found_decoder;  
109.     } *info;  
110.   
111.     int pts_wrap_bits; /**< number of bits in pts (used for wrapping control) */  
112.   
113.     // Timestamp generation support:  
114.     /** 
115.      * Timestamp corresponding to the last dts sync point. 
116.      * 
117.      * Initialized when AVCodecParserContext.dts_sync_point >= 0 and 
118.      * a DTS is received from the underlying container. Otherwise set to 
119.      * AV_NOPTS_VALUE by default. 
120.      */  
121.     int64_t reference_dts;  
122.     int64_t first_dts;  
123.     int64_t cur_dts;  
124.     int64_t last_IP_pts;  
125.     int last_IP_duration;  
126.   
127.     /** 
128.      * Number of packets to buffer for codec probing 
129.      */  
130. #define MAX_PROBE_PACKETS 2500  
131.     int probe_packets;  
132.   
133.     /** 
134.      * Number of frames that have been demuxed during av_find_stream_info() 
135.      */  
136.     int codec_info_nb_frames;  
137.   
138.     /** 
139.      * Stream Identifier 
140.      * This is the MPEG-TS stream identifier +1 
141.      * 0 means unknown 
142.      */  
143.     int stream_identifier;  
144.   
145.     int64_t interleaver_chunk_size;  
146.     int64_t interleaver_chunk_duration;  
147.   
148.     /* av_read_frame() support */  
149.     enum AVStreamParseType need_parsing;  
150.     struct AVCodecParserContext *parser;  
151.   
152.     /** 
153.      * last packet in packet_buffer for this stream when muxing. 
154.      */  
155.     struct AVPacketList *last_in_packet_buffer;  
156.     AVProbeData probe_data;  
157. #define MAX_REORDER_DELAY 16  
158.     int64_t pts_buffer[MAX_REORDER_DELAY+1];  
159.   
160.     AVIndexEntry *index_entries; /**< Only used if the format does not 
161.                                     support seeking natively. */  
162.     int nb_index_entries;  
163.     unsigned int index_entries_allocated_size;  
164.   
165.     /** 
166.      * flag to indicate that probing is requested 
167.      * NOT PART OF PUBLIC API 
168.      */  
169.     int request_probe;  
170. } AVStream;  

AVStream重要的变量如下所示：

int index：标识该视频/音频流

AVCodecContext *codec：指向该视频/音频流的AVCodecContext（它们是一一对应的关系）

AVRational time_base：时基。通过该值可以把PTS，DTS转化为真正的时间。FFMPEG其他结构体中也有这个字段，但是根据我的经验，只有AVStream中的time_base是可用的。PTS*time_base=真正的时间

int64_t duration：该视频/音频流长度

AVDictionary *metadata：元数据信息

AVRational avg_frame_rate：帧率（注：对视频来说，这个挺重要的）

AVPacket attached_pic：附带的图片。比如说一些MP3，AAC音频文件附带的专辑封面。

该结构体其他字段的作用目前还有待于探索。