iOS中AVAssetWriterInputTaggedPixelBufferGroupAdaptor.appendTaggedBuffers返回false问题

一、示例代码并非仅支持M1芯片，但MV-HEVC存在硬件支持限制 #

苹果官方的Side-By-Side转MV-HEVC示例依赖硬件加速的MV-HEVC编码器：

• M1及后续Apple Silicon芯片（包括M1 iPad Air、MacBook Air）原生支持MV-HEVC硬件编码，因此运行稳定；
• 部分旧款iOS设备（如A13及更早的芯片）无MV-HEVC硬件编码能力，系统会 fallback 到软件编码路径，但软件编码的兼容性和稳定性较差，容易出现appendTaggedBuffers返回false的情况。

你可以通过以下方式验证设备支持性：

• 创建VTCompressionSession前，查询kCMVideoCodecType_HEVC的编码器属性，检查是否包含多视图（Multiview）相关支持标识；
• 尝试开启kVTVideoEncoderSpecification_EnableHardwareAcceleratedVideoEncoder属性，若session创建失败，则说明设备无硬件编码支持。

二、iOS迁移时容易遗漏的关键注意事项 #

1. 严格控制内存与缓冲区生命周期 #

iOS的内存阈值远低于macOS，缓冲区堆积或内存泄漏会直接导致appendTaggedBuffers失败：

• 每帧编码完成后（通过VTCompressionSession的输出回调），立即调用CMSampleBufferInvalidate并释放buffer引用，避免内存占用过高；
• 不要批量生成大量taggedBuffers再一次性append，改成逐帧生成、逐帧append的方式，降低内存峰值。

2. 适配iOS特定的编码会话配置 #

macOS命令行的默认配置在iOS上可能不兼容，需调整以下参数：

• 显式设置kVTCompressionPropertyKey_MultiviewEnabled为true，并正确配置视图数量（通常为2）、视图布局（对应Side-By-Side的左右视图映射）；
• 确保输入像素格式与iOS硬件编码器兼容，优先使用kCVPixelFormatType_420YpCbCr8BiPlanarFullRange；
• 若出现帧顺序问题，尝试设置kVTCompressionPropertyKey_AllowFrameReordering为false（MV-HEVC对帧顺序要求更严格）。

3. 统一编码操作的线程队列 #

iOS上VTCompressionSession的所有操作必须在同一个串行dispatch队列上执行：

• 创建session时指定专属的串行队列；
• 调用appendTaggedBuffers、结束session等操作必须在该队列上执行，避免跨线程竞争导致的不稳定。

4. 处理iOS的权限与后台限制 #

• 若在后台执行转换，需在Info.plist中添加对应后台模式权限（如audio或Processing后台任务），否则系统会强制限制编码进程；
• 若视频源来自相册，需确保已获取Photo Library访问权限，否则可能导致buffer数据不完整，触发append失败。

内容的提问来源于stack exchange，提问作者timyau