Olive视频编辑器在FFmpeg 7.0环境下的编译问题解析

问题背景

Olive是一款开源的视频编辑软件，其核心功能依赖于FFmpeg多媒体框架。近期有用户在Ubuntu 24.04系统（代号Noble）上尝试编译Olive时遇到了编译错误，该系统默认安装了FFmpeg 7.0版本。

错误现象

编译过程中出现的核心错误信息如下：

/app/olive/ext/core/src/render/audioparams.cpp: In member function 'void olive::core::AudioParams::calculate_channel_count()':
/app/olive/ext/core/src/render/audioparams.cpp:162:20: error: 'av_get_channel_layout_nb_channels' was not declared in this scope
  162 |   channel_count_ = av_get_channel_layout_nb_channels(channel_layout());

这个错误表明Olive代码中调用的FFmpeg API函数av_get_channel_layout_nb_channels在FFmpeg 7.0中已经不可用。

技术分析

FFmpeg API变更

FFmpeg作为一个活跃开发的多媒体框架，其API在不同版本间会有变化。特别是从FFmpeg 5.0开始，一些长期被标记为"deprecated"(已弃用)的API开始被移除。av_get_channel_layout_nb_channels函数就是其中之一。

Olive的兼容性

Olive项目目前主要针对FFmpeg 4.x和5.0版本进行开发和测试。虽然FFmpeg 6.0可能还能工作，但7.0版本已经移除了这个关键函数，导致编译失败。

解决方案

推荐方案：使用兼容的FFmpeg版本

1. 卸载系统FFmpeg 7.0：首先需要移除或降级系统安装的FFmpeg 7.0
2. 安装FFmpeg 5.0：这是Olive官方测试支持的版本
3. 从源码编译FFmpeg：如果系统仓库中没有5.0版本，可以从源码编译安装

从源码编译FFmpeg的步骤

1. 下载FFmpeg 5.0源码
2. 配置编译选项：

   ./configure --prefix="/path/to/ffmpeg/install" --enable-shared
   

3. 编译并安装：

   make && make install
   

配置Olive使用指定FFmpeg版本

1. 设置环境变量：

   export LD_LIBRARY_PATH=/path/to/ffmpeg/install/lib:$LD_LIBRARY_PATH
   

2. 在编译Olive时指定FFmpeg路径：

   cmake .. -DFFMPEG_ROOT=/path/to/ffmpeg/install
   

注意事项

1. 确保FFmpeg安装目录结构正确，必须包含include和lib子目录
2. 编译Olive前，确认CMake输出的FFmpeg路径是否正确指向了自定义安装的版本
3. 如果系统中有多个FFmpeg版本，运行时可能需要设置LD_LIBRARY_PATH环境变量

未来展望

虽然当前Olive代码尚未适配FFmpeg 7.0，但随着FFmpeg新版本的普及，项目可能会在未来更新代码以支持新版本API。开发者可以关注项目更新，或者考虑贡献代码来支持新版本FFmpeg。

对于需要长期稳定使用的用户，建议锁定FFmpeg 5.0版本，这是经过Olive官方测试的兼容版本。