【FFmpeg】AVPacket结构体
- 1.AVPacket结构体的定义
示例工程：
【FFmpeg】调用ffmpeg库实现264软编
【FFmpeg】调用ffmpeg库实现264软解
【FFmpeg】调用ffmpeg库进行RTMP推流和拉流
【FFmpeg】调用ffmpeg库进行SDL2解码后渲染
流程分析：
【FFmpeg】编码链路上主要函数的简单分析
【FFmpeg】解码链路上主要函数的简单分析
结构体分析：
【FFmpeg】AVCodec结构体
【FFmpeg】AVCodecContext结构体
【FFmpeg】AVStream结构体
【FFmpeg】AVFormatContext结构体
【FFmpeg】AVIOContext结构体
1.AVPacket结构体的定义
AVPacket结构体定义在libavcodec\codec.h中，通常用于存储已编码之后的数据，例如264格式的视频数据
/*** This structure stores compressed data. It is typically exported by demuxers* and then passed as input to decoders, or received as output from encoders and* then passed to muxers.** For video, it should typically contain one compressed frame. For audio it may* contain several compressed frames. Encoders are allowed to output empty* packets, with no compressed data, containing only side data* (e.g. to update some stream parameters at the end of encoding).** The semantics of data ownership depends on the buf field.* If it is set, the packet data is dynamically allocated and is* valid indefinitely until a call to av_packet_unref() reduces the* reference count to 0.** If the buf field is not set av_packet_ref() would make a copy instead* of increasing the reference count.** The side data is always allocated with av_malloc(), copied by* av_packet_ref() and freed by av_packet_unref().** sizeof(AVPacket) being a part of the public ABI is deprecated. once* av_init_packet() is removed, new packets will only be able to be allocated* with av_packet_alloc(), and new fields may be added to the end of the struct* with a minor bump.** @see av_packet_alloc* @see av_packet_ref* @see av_packet_unref*/
// 1.该结构存储压缩数据。它通常由解复用器导出，然后作为输入传递给解码器，或者作为编码器的输出接收，然后传递给解码器
//
// 2.对于视频，它通常应该包含一个压缩帧。对于音频，它可能包含几个压缩帧。编码器允许输出空数据包，没有压缩数据，只包含侧数据(例如，在编码结束时更新一些流参数)
//
// 3.数据所有权的语义取决于buf字段。如果设置了该值，则数据包数据将被动态分配并无限期有效，直到调用av_packet_unref()将引用计数减少为0
//
// 4.如果没有设置buf字段，av_packet_ref()将复制而不是增加引用计数
//
// 5.辅助数据总是由av_malloc()分配，由av_packet_ref()复制，由av_packet_unref()释放。
//
// 6.不赞成将sizeof(AVPacket)作为公共ABI的一部分。一旦av_init_packet()被删除，新的数据包将只能用av_packet_alloc()分配，新的字段可能会添加到结构体的末尾
typedef struct AVPacket {/*** A reference to the reference-counted buffer where the packet data is* stored.* May be NULL, then the packet data is not reference-counted.*/// 对存储数据包数据的引用计数缓冲区的引用AVBufferRef *buf;/*** Presentation timestamp in AVStream->time_base units; the time at which* the decompressed packet will be presented to the user.* Can be AV_NOPTS_VALUE if it is not stored in the file.* pts MUST be larger or equal to dts as presentation cannot happen before* decompression, unless one wants to view hex dumps. Some formats misuse* the terms dts and pts/cts to mean something different. Such timestamps* must be converted to true pts/dts before they are stored in AVPacket.*/// AVStream->time_base单位表示时间戳;解压后的数据包呈现给用户的时间// 可以AV_NOPTS_VALUE，如果它不是存储在文件// pts必须大于或等于dts，因为在解压缩之前无法显示，除非想要查看十六进制转储。有些格式误用术语dts和pts/cts来表示不同的含义。这样的时间戳必须转换为真正的pts/dts，然后才能存储在AVPacket中int64_t pts;/*** Decompression timestamp in AVStream->time_base units; the time at which* the packet is decompressed.* Can be AV_NOPTS_VALUE if it is not stored in the file.*/// 解压时间戳在AVStream->time_base单位;数据包被解压的时间// 可以AV_NOPTS_VALUE，如果它不是存储在文件int64_t dts;// 存储已压缩的数据uint8_t *data;// 数据大小int size;// 流索引号int stream_index;/*** A combination of AV_PKT_FLAG values*/// AV_PKT_FLAG值的组合/*#define AV_PKT_FLAG_KEY 0x0001 ///< The packet contains a keyframe#define AV_PKT_FLAG_CORRUPT 0x0002 ///< The packet content is corrupted#define AV_PKT_FLAG_DISCARD 0x0004 ///< 标志用于丢弃需要保持有效解码器状态但不需要输出的数据包，并且在解码后应该丢弃#define AV_PKT_FLAG_TRUSTED 0x0008 ///< 数据包来自可信来源，否则，可能会遵循不安全的结构，例如指向数据包外部数据的任意指针#define AV_PKT_FLAG_DISPOSABLE 0x0010 /// <标志用于指示包含可被解码器丢弃的帧的数据包。即非参考系*/int flags;/*** Additional packet data that can be provided by the container.* Packet can contain several types of side information.*/// 容器可以提供的附加数据包数据// 包可以包含几种类型的副信息AVPacketSideData *side_data;int side_data_elems;/*** Duration of this packet in AVStream->time_base units, 0 if unknown.* Equals next_pts - this_pts in presentation order.*/// 该数据包在AVStream->time_base单位中的持续时间，如果未知则为0。按表示顺序等于next_pts - this_ptsint64_t duration;// 码流中字节的位置，如果不知道则设置为-1int64_t pos; ///< byte position in stream, -1 if unknown/*** for some private data of the user*/// 用户的一些私有数据void *opaque;/*** AVBufferRef for free use by the API user. FFmpeg will never check the* contents of the buffer ref. FFmpeg calls av_buffer_unref() on it when* the packet is unreferenced. av_packet_copy_props() calls create a new* reference with av_buffer_ref() for the target packet's opaque_ref field.** This is unrelated to the opaque field, although it serves a similar* purpose.*/// 1.AVBufferRef供API用户免费使用。FFmpeg永远不会检查缓冲区ref的内容。当数据包未被引用时，// FFmpeg会对其调用av_buffer_unref()。Av_packet_copy_props()调用用av_buffer_ref()为目标包的opaque字段创建一个新的引用// // 2.这与opaque字段无关，尽管它的目的相似AVBufferRef *opaque_ref;/*** Time base of the packet's timestamps.* In the future, this field may be set on packets output by encoders or* demuxers, but its value will be by default ignored on input to decoders* or muxers.*/// 数据包时间戳的时间基础// 将来，该字段可能会在编码器或解码器输出的数据包上设置，但默认情况下，它的值将在解码器或复用器输入时被忽略AVRational time_base;
} AVPacket;
AVPacket结构体的定义与老版本相似，基本没有大的改动，其中比较关键的内容包括：
（1）uint8_t *data：存储压缩数据的变量
（2）int size：数据大小
（3）int stream_index：流的索引号
（4）int flags：描述当前pkt的使用情况
（5）int64_t pts：解压后的数据包呈现给用户的时间
（6）int64_t dts：数据包被解压的时间
CSDN : https://blog.csdn.net/weixin_42877471
Github : https://github.com/DoFulangChen