从零到一学FFmpeg：av_interleaved_write_frame 函数详析与实战

---

前言

av_interleaved_write_frame是FFmpeg库中的一个函数，用于将一个已编码的媒体数据包（AVPacket）写入到输出媒体文件或流中。
此函数特别关注于维护正确的交错（interleaving）顺序，即确保视频和音频帧按照它们应该播放的顺序被写入，这对于生成可正确播放的多媒体文件至关重要。

---

提示：以下是本篇文章正文内容，下面案例可供参考

一、函数原型

int av_interleaved_write_frame(AVFormatContext *fmt_ctx, AVPacket *pkt);

参数说明

fmt_ctx: 指向AVFormatContext结构体的指针，表示输出媒体文件或流的上下文。
	它包含了文件格式信息、输出流信息等。
pkt: 指向待写入的AVPacket结构体的指针。
	这个数据包应该已经被编码器填充，包含了编码后的媒体数据及其时间戳等信息。

返回值

成功时返回0。
失败时返回负的错误代码，可以通过av_strerror转换为错误信息。

二、功能描述

交错写入: 该函数负责按照正确的时间顺序交错写入视频帧、音频帧等媒体数据包。即使数据包到达的顺序与播放顺序不一致，av_interleaved_write_frame也会尽量确保它们被正确排序后写入，这对于支持流式传输和保证播放流畅性特别重要。

时间戳调整: 在写入数据包前，函数还会根据输出上下文的时间基调整数据包的时间戳，确保跨不同格式和编码器的一致性。

缓冲与同步: 实际写入时可能会涉及内部缓冲，以优化I/O性能并处理同步问题，尤其是在需要精确控制数据包输出时机的情况下。

三、使用场景

同步音频和视频: 在播放视频时，经常需要同步音频流和视频流，这两个流可能有不同的时间基。通过av_compare_ts，可以确保两者的播放保持同步。

媒体剪辑: 在进行视频编辑时，需要比较不同时间点来决定剪切、合并的位置，av_compare_ts能帮助精确地进行这些操作。

播放控制: 如快进、后退、跳转等功能的实现，需要根据用户请求的时间点和当前播放位置进行比较，从而决定如何调整播放状态。

四、使用实例

在调用av_interleaved_write_frame之前，必须确保相关的输出流已被正确设置，且编码器已经创建并配置完毕。
写入完成后，最好通过检查返回值来判断操作是否成功，并进行相应的错误处理。
当完成所有数据包的写入后，应当调用av_write_trailer来写入文件尾部信息，以确保输出文件的完整性。

AVFormatContext *fmt_ctx = ...; // 已初始化的输出格式上下文
AVPacket pkt;
// 假设pkt已被编码器填充，包含了编码后的数据

int ret = av_interleaved_write_frame(fmt_ctx, &pkt);
if (ret < 0) {
    fprintf(stderr, "Error writing frame: %d\n", ret);
    return -1;
}
// 数据包写入成功，现在可以释放pkt
av_packet_unref(&pkt);