FFmpeg 集成 libxvid（XviD 视频编解码器）-优快云博客

本文链接：https://blog.youkuaiyun.com/csdn_tom_168/article/details/149080897

在 Linux 环境下为 FFmpeg 集成 libxvid（XviD 视频编解码器），需完成依赖安装、FFmpeg 源码编译配置及验证步骤。以下是详细操作指南：

一、libxvid 简介

XviD 是一种开源的 MPEG-4 视频编解码器（属于 MPEG-4 Part 2 标准），广泛用于早期视频压缩（如 DivX 兼容格式）。FFmpeg 可通过集成 libxvid 库支持 XviD 视频的编码（压缩）和解码（播放）。

二、前置条件

Linux 系统：推荐 Ubuntu 20.04+/CentOS 7+（需支持 GCC、CMake 等工具）。
FFmpeg 源码：从 FFmpeg 官网克隆最新稳定版（如 6.0+）。
libxvid 开发库：需安装 libxvid 的头文件（.h）和动态库（.so），用于 FFmpeg 编译时链接。

三、安装 libxvid 开发库

libxvid 的开发库需手动编译安装（主流 Linux 发行版仓库通常不提供预编译包）。

1. 下载 libxvid 源码

git clone https://github.com/xvidorg/xvid.git
cd xvid

2. 编译并安装 libxvid

# 创建构建目录
mkdir build && cd build

# 配置编译选项（默认安装到 /usr/local）
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local \
         -DENABLE_SHARED=ON \       # 编译共享库（必选）
         -DENABLE_STATIC=OFF        # 不编译静态库（可选）

# 编译并安装
make -j$(nproc)
sudo make install

3. 验证安装

安装完成后，检查 libxvid 库是否被系统识别：

# 查看动态库路径
ldconfig -p | grep libxvid
# 输出示例：libxvidcore.so.4 (libc6,x86-64) => /usr/local/lib/libxvidcore.so.4

四、配置 FFmpeg 编译选项

FFmpeg 需通过 ./configure 脚本启用 libxvid 支持，关键是关联 libxvid 库的路径。

1. 下载 FFmpeg 源码

git clone https://git.ffmpeg.org/ffmpeg.git ffmpeg
cd ffmpeg

2. 配置编译参数

在 ./configure 中添加以下参数（根据 libxvid 的实际安装路径调整）：

./configure \
    --prefix=/usr/local \          # FFmpeg 安装路径
    --enable-shared \              # 编译共享库（必选）
    --enable-static \              # 编译静态库（可选）
    --enable-libxvid \             # 启用 XviD 编解码器（关键参数）
    --extra-cflags="-I/usr/local/include" \  # libxvid 头文件路径
    --extra-ldflags="-L/usr/local/lib"     # libxvid 库文件路径

参数说明

--enable-libxvid：显式启用 XviD 编解码器支持（依赖 libxvidcore 库）。
--extra-cflags：指定 libxvid 头文件路径（若未安装到系统默认路径 /usr/include）。
--extra-ldflags：指定 libxvid 库文件路径（若未安装到系统默认路径 /usr/lib）。

3. 验证配置是否识别 libxvid

配置完成后，运行 ./config.log 或 make 时观察日志，确认 XviD 编解码器被正确识别：

Enabled encoders: ... libxvid ...
Enabled decoders: ... libxvid ...

五、编译与安装 FFmpeg

配置通过后，编译并安装 FFmpeg：

# 编译（-j 参数根据 CPU 核心数优化速度）
make -j$(nproc)

# 安装到系统目录（需要 sudo 权限）
sudo make install

六、运行时环境设置

安装完成后，需确保系统能找到 libxvid 和 FFmpeg 的动态库。

1. 更新动态链接库缓存

# 若 libxvid 和 FFmpeg 库安装在 /usr/local/lib，需将其路径添加到系统库路径
echo '/usr/local/lib' | sudo tee -a /etc/ld.so.conf.d/xvid-ffmpeg.conf
sudo ldconfig

2. 验证 FFmpeg 是否支持 XviD 编解码

运行以下命令查看 FFmpeg 支持的编解码器：

ffmpeg -codecs | grep xvid

若输出类似 D.V.L. libxvid XviD (MPEG-4) (decoder: libxvid_decoder) (encoder: libxvid_encoder)，则集成成功。

七、测试 XviD 编解码

使用 FFmpeg 验证 XviD 编解码功能，例如将 MP4 视频编码为 XviD 格式或从 XviD 视频解码。

1. 编码测试（MP4 → XviD）

# 将输入视频（如 input.mp4）编码为 XviD 格式（输出为 output.avi）
ffmpeg -i input.mp4 \
    -c:v libxvid \
    -q:v 5 \          # 质量参数（0-31，值越小质量越高）
    -c:a mp3 \        # 音频编码（可选，推荐 MP3）
    output.avi

2. 解码测试（XviD → MP4）

# 将 XviD 视频（output.avi）解码为 H.264 格式（输出为 decoded.mp4）
ffmpeg -i output.avi \
    -c:v libx264 \    # 解码为 H.264（兼容播放器）
    -c:a copy \       # 音频流直接复制
    decoded.mp4

八、常见问题与解决

问题 1：`configure` 报错“libxvid not found”

原因：FFmpeg 未找到 libxvid 库或头文件。
解决：
1. 确认 libxvid 已正确安装（通过 ldconfig -p | grep libxvidcore 检查）。
2. 手动指定 libxvid 路径（若安装到非默认路径）：
```
./configure --extra-cflags="-I/path/to/xvid/include" --extra-ldflags="-L/path/to/xvid/lib"
```

问题 2：编译时报错“undefined reference to `xvid_global_init’”

原因：链接阶段未正确链接 libxvidcore 库。
解决：检查 --extra-ldflags 是否包含 libxvidcore.so 的路径，或重新编译 libxvid 并确保 libxvidcore.so 存在。

问题 3：运行 `ffmpeg` 时提示“cannot open shared object file”

原因：系统找不到 libxvidcore.so 或 FFmpeg 的动态库。
解决：
- 通过 LD_LIBRARY_PATH 临时指定路径：
```
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
ffmpeg -i input.mp4 ...
```
- 永久生效：将 /usr/local/lib 添加到 /etc/ld.so.conf.d/ 并运行 sudo ldconfig。