SimpleScreenRecorder音频编码器兼容性问题分析与解决方案

问题背景

SimpleScreenRecorder(简称SSR)是一款流行的开源屏幕录制工具，近期用户反馈在升级FFmpeg到7.0.2版本后，使用H.264+AAC编码组合录制MP4视频时出现错误。错误信息显示"AAC编码器不支持'2 channels'的声道布局"，导致初始化失败。

技术分析

该问题源于FFmpeg 6.0版本后对音频通道布局API的重大变更。在FFmpeg 6.0之前，开发者通过直接设置codec_context->channels和codec_context->channel_layout来配置音频通道。但从FFmpeg 6.0开始，引入了新的ch_layout结构体来管理声道布局，旧API被逐步废弃。

SSR代码中仍使用旧版API设置声道布局，当检测到立体声(2声道)时，简单地设置"2 channels"字符串，这已不被新版FFmpeg的AAC和MP3编码器所支持。编码器期望接收标准的声道布局掩码，如AV_CH_LAYOUT_MONO(单声道)或AV_CH_LAYOUT_STEREO(立体声)。

解决方案

针对此兼容性问题，开发者社区已提出修复方案，核心修改点在于音频编码器初始化部分：

1. 对于FFmpeg 6.1及以上版本，使用新的av_channel_layout_from_maskAPI
2. 对于旧版FFmpeg，保持原有的通道设置方式

具体实现如下：

#if LIBAVCODEC_VERSION_MAJOR < 61
    codec_context->channels = channels;
    codec_context->channel_layout = (channels == 1)? AV_CH_LAYOUT_MONO : AV_CH_LAYOUT_STEREO;
#else
    if(channels == 1) {
        av_channel_layout_from_mask(&codec_context->ch_layout, AV_CH_LAYOUT_MONO);
    } else {
        av_channel_layout_from_mask(&codec_context->ch_layout, AV_CH_LAYOUT_STEREO);
    }
#endif

影响范围

此问题不仅影响AAC编码器，同样会影响其他音频编码器如MP3(libmp3lame)。任何使用新版FFmpeg(6.0+)编译的SSR都可能遇到此问题，表现为无法初始化音频编码器。

用户建议

对于遇到此问题的用户，可以采取以下措施：

1. 手动应用上述补丁并重新编译SSR
2. 暂时降级FFmpeg到5.x版本
3. 等待官方发布包含此修复的新版本

对于开发者而言，这提醒我们在使用FFmpeg等活跃开发的多媒体库时，需要密切关注其API变更，特别是大版本更新可能带来的不兼容改动。

总结

FFmpeg 6.0的API变更导致了SSR音频编码器初始化失败，通过条件编译和使用新版声道布局API可以解决此兼容性问题。这反映了多媒体开发中保持API同步更新的重要性，也为处理类似兼容性问题提供了参考方案。