FFmpeg自定义AVIOContext写内存时avformat_write_header无输出头
核心问题原因
两个FFmpeg的默认运行机制叠加,导致了头部数据丢失、回调不触发的现象:
- AVIO层的内置缓存规则:FFmpeg为了减少IO调用次数,会把写入的数据先存在你通过
avio_alloc_context传入的32KB本地缓存中,只有当缓存写满、或是手动触发缓存刷出时,才会调用你注册的write_buffer回调把数据交付给外部。avformat_write_header生成的头部内容长度通常只有几十到几百字节,远低于32KB的缓存触发阈值,因此这部分内容会一直留在内部缓存中,不会在avformat_write_header调用阶段就触发回调,这是正常设计而非异常。 - 流程收尾时缺少缓存刷出步骤:当整个文件写入流程结束(包括写头部、写所有帧、写文件尾)时,如果没有主动把AVIO缓存中剩余的、未达到满阈值的数据强制刷出,这部分留在缓存里的内容(也就是开头的头部、最后一块不足32KB的帧数据)会被直接丢弃,最终你拿到的存储容器里就只剩下之前缓存满时触发回调送来的纯帧内容,完全缺失头部。
额外说明:如果你当前指定的输出格式是s16le,这本身是无文件头的裸PCM格式,不存在需要生成的文件头部内容,所有输出内容都是连续的音频采样值;如果你实际需要带文件头的输出(比如WAV格式),需要调整avformat_alloc_output_context2传入的格式名。
正确的实现流程
按照以下步骤调整代码即可解决问题:
- 修正AVIO上下文的参数传递,避免依赖全局变量:把存储输出数据的
std::vector<char>指针作为avio_alloc_context的opaque参数传入,在write_buffer回调中通过opaque获取目标容器指针,不要使用全局变量。 - 在所有写入操作全部完成后,主动刷出AVIO缓存:在调用完
av_write_trailer(containerContext)之后,立刻执行avio_flush(containerContext->pb),强制把内部缓存中所有剩余数据通过write_buffer回调写入目标vector,保证头部和最后一块帧数据不会丢失。 - 确认封装格式匹配实际需求:如果需要带格式头部的输出(比如WAV),把
avformat_alloc_output_context2的格式参数从s16le改为wav,此时avformat_write_header会自动生成对应格式的标准头部,写入AVIO缓存,最终通过flush操作被你的回调收集到。
注意:avformat_write_header调用阶段不触发write_buffer是FFmpeg的正常设计,不需要在这个阶段强制刷出数据,只要在整个写入流程结束后统一flush,就能完整收集到所有数据,包括头部。
修正后的关键代码参考
// 初始化存储输出的容器 std::vector<char>* output_data = new std::vector<char>(); unsigned char* aviobuffer = (unsigned char *)av_malloc(32768); // 把output_data作为opaque传入,替代原来的NULL AVIOContext* avio = avio_alloc_context( aviobuffer, 32768, 1, /* opaque */ output_data, NULL, write_buffer, NULL ); AVFormatContext* containerContext = NULL; // 如果需要WAV格式的头部,这里格式名传wav而非s16le avformat_alloc_output_context2(&containerContext, NULL, "wav", NULL); containerContext->pb = avio; containerContext->flags |= AVFMT_FLAG_CUSTOM_IO; // 配置流参数、调用avformat_write_header的逻辑保持不变 int ret = avformat_write_header(containerContext, NULL); // 循环调用av_write_frame写入所有重采样后的音频帧的逻辑保持不变 // 写完所有帧和尾部后,先刷缓存 av_write_trailer(containerContext); avio_flush(containerContext->pb);
修正后的write_buffer实现:
int write_buffer(void *opaque, uint8_t *buf, int buf_size) { // 通过opaque获取目标容器,不依赖全局变量 std::vector<char>* target = static_cast<std::vector<char>*>(opaque); // 直接把回调收到的数据追加到容器,无需构造临时vector target->insert(target->end(), buf, buf + buf_size); return buf_size; }
内容的提问来源于stack exchange,提问作者Mohamed Kandeel
相关产品推荐
相关产品推荐

