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

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