GoldenDict-NG项目中的FFmpeg音频后端兼容性问题分析

背景介绍

GoldenDict-NG作为一款开源的词典软件，其音频播放功能一直依赖于FFmpeg后端实现。近期随着FFmpeg 7.0版本的发布，项目中的音频播放模块出现了编译错误，这引发了开发者社区关于是否继续维护FFmpeg后端的讨论。

技术问题分析

在FFmpeg 7.0中，API发生了重大变更，移除了AVCodecContext结构体中的几个关键字段：

• 删除了channels字段
• 移除了channel_layout字段
• 弃用了avcodec_close函数

这些变更直接导致GoldenDict-NG的ffmpegaudio.cc源文件出现多处编译错误。错误主要集中在音频通道数获取和声道布局处理等核心功能上。

解决方案讨论

开发团队提出了几种解决方案：

1. 完全移除FFmpeg后端：

   • 现代Qt6多媒体框架已内置FFmpeg后端
   • 通过设置QT_MEDIA_BACKEND=ffmpeg环境变量可强制使用FFmpeg
   • 这能简化代码维护，但会限制用户选择

2. 条件编译控制：

   • 将WITH_FFMPEG_PLAYER选项默认设为OFF
   • 保留代码但默认不编译，作为过渡方案

3. 适配FFmpeg 7.0新API：

   • 使用新的ch_layout结构体替代旧字段
   • 需要重写相关音频处理逻辑

跨平台兼容性考量

不同平台和发行版的情况需要特别关注：

• Windows平台：Qt多媒体可能默认使用Windows媒体API而非FFmpeg
• Linux发行版：
  • Ubuntu 24.04 LTS将长期使用Qt 6.4
  • Debian/Devuan等保守发行版版本较旧
• 打包部署：需要确保FFmpeg动态库正确打包

未来发展方向

开发团队计划在Qt 6.8 LTS发布后(2024年9月)进行架构调整：

• 彻底移除Qt5支持
• 删除qmake构建系统
• 可能完全移除FFmpeg后端代码

用户建议

对于不同用户群体：

1. 开发者：

   • 可尝试手动适配FFmpeg 7.0 API
   • 或等待官方解决方案

2. 终端用户：

   • Linux用户可设置环境变量强制使用FFmpeg
   • Windows用户需确保系统媒体组件完整

3. 打包维护者：

   • 需要关注后续版本对Qt最低版本的要求
   • 准备应对FFmpeg后端的移除

这个过渡期将持续数月，用户和开发者都需要关注项目的后续更新，以获取最佳的兼容性解决方案。