通用文档

1 外部库

FFmpeg 可以与许多外部库搭配使用，以增加对更多格式的支持。默认情况下不会使用任何一个，必须通过向 ./configure 传递相应的标志来显式启用。

1.1 Alliance for Open Media (AOM)

FFmpeg 可以使用 AOM 库进行 AV1 解码和编码。

访问 http://aomedia.org/ 并按照说明安装该库，然后在 configure 时传入 --enable-libaom 即可启用。

1.2 AMD AMF/VCE

FFmpeg 可以使用 AMD Advanced Media Framework 库，在配备 Video Coding Engine (VCE) 的硬件上加速 H.264 和 HEVC（仅限 Windows）编码。

要启用支持，必须从 https://github.com/GPUOpen-LibrariesAndSDKs/AMF.git 获取 AMF 框架的头文件（1.4.9 及以上版本）。

在系统 include 路径下创建一个 AMF/ 目录，将 AMF/amf/public/include/ 的内容复制到该目录中，然后使用 --enable-amf 来配置 FFmpeg。

amf encoder 按以下顺序进行初始化：1）尝试通过 dx11（仅限 Windows）初始化 2）尝试通过 dx9（仅限 Windows）初始化 3）尝试通过 vulkan 初始化

要在 linux 上使用 h.264(AMD VCE) encoder，需要 amdgru-pro 19.20 及以上版本，以及 amf-amdgpu-pro 软件包（amdgru-pro 中已包含，但不会自动安装）。

该驱动可以使用官方 amd 驱动归档中的 amdgpu-pro-install 脚本来安装。

1.3 AviSynth

FFmpeg 可以将 AviSynth 脚本作为输入读取。要启用支持，请先安装 AviSynth+ 提供的头文件，然后在 configure 时传入 --enable-avisynth。可以通过向常规的基于 CMake 的构建系统传入 -DHEADERS_ONLY:bool=on，或使用随附的 GNUmakefile，来配置 AviSynth+ 仅安装头文件。

在 Windows 上，支持的 AviSynth 版本为：32 位构建对应 AviSynth 2.6 RC1 或更高版本，32 位和 64 位构建对应 AviSynth+ r1718 或更高版本。

在 Linux、macOS 和 BSD 上，唯一支持的 AviSynth 版本是 AviSynth+，且需要 3.5 及以上版本。

2016 年，AviSynth+ 增加了使用 GCC 构建的支持。但由于 Windows 调用约定的特殊性，AviSynth+ 的 32 位 GCC 构建与常见的 32 位 FFmpeg 构建不兼容。

默认情况下，FFmpeg 假定与 AviSynth+ 的 32 位 MSVC 构建兼容，因为这是使用最广泛、也最根深蒂固的构建配置。用户可以在配置 FFmpeg 时向 --extra-cflags 传入 -DAVSC_WIN32_GCC32，以覆盖这一默认设置并启用对 AviSynth+ 32 位 GCC 构建的支持。

64 位的 FFmpeg 构建不受此问题影响，无需任何特殊标志即可使用 AviSynth+ 的 MSVC 或 GCC 构建。

AviSynth(+) 是动态加载的。发行方可以使用 --enable-avisynth 构建 FFmpeg，生成的二进制文件无论终端用户是否安装了 AviSynth 都能正常运行。如果终端用户想要使用 AviSynth 脚本，只需安装 AviSynth(+)，FFmpeg 便能找到并使用它来打开脚本。

1.4 Chromaprint

FFmpeg 可以使用 Chromaprint 库来生成音频指纹。在 configure 时传入 --enable-chromaprint 即可启用。参见 https://acoustid.org/chromaprint。

1.5 codec2

FFmpeg 可以使用 codec2 库进行 codec2 解码和编码。目前还没有原生 decoder，因此解码必须使用 libcodec2。

访问 http://freedv.org/，下载 "Codec 2 source archive"。使用 CMake 构建并安装。Debian 用户也可以直接安装 libcodec2-dev 软件包。安装好 libcodec2 之后，在 configure 时传入 --enable-libcodec2 即可启用。

使用 codec2 最简单的方式是采用 .c2 文件，因为其中包含了解码所需的模式信息。要生成这样的文件，请使用 .c2 扩展名，并向 libcodec2 encoder 提供 -mode 选项，例如：ffmpeg -i input.wav -mode 700C output.c2。播放时只需运行 ffplay output.c2 即可。要查看支持的模式列表，可运行 ffmpeg -h encoder=libcodec2。原始 codec2 文件同样受支持，要正确解析它们，需要将所使用的模式指定为格式选项，例如：ffmpeg -f codec2raw -mode 1300 -i input.raw output.wav。

1.6 dav1d

FFmpeg 可以使用 dav1d 库进行 AV1 视频解码。

访问 https://code.videolan.org/videolan/dav1d 并按照说明安装该库，然后在 configure 时传入 --enable-libdav1d 即可启用。

1.7 davs2

FFmpeg 可以使用 davs2 库进行 AVS2-P2/IEEE1857.4 视频解码。

访问 https://github.com/pkuvcl/davs2 并按照说明安装该库，然后在 configure 时传入 --enable-libdavs2 即可启用。

libdavs2 采用 GNU Public License Version 2 或更高版本授权（详见 http://www.gnu.org/licenses/old-licenses/gpl-2.0.html），使用它需要将 FFmpeg 的许可证升级为 GPL。

1.8 uavs3d

FFmpeg 可以使用 uavs3d 库进行 AVS3-P2/IEEE1857.10 视频解码。

访问 https://github.com/uavs3/uavs3d 并按照说明安装该库，然后在 configure 时传入 --enable-libuavs3d 即可启用。

1.9 Game Music Emu

FFmpeg 可以使用 Game Music Emu 库，从受支持的电子游戏音乐文件格式中读取音频。在 configure 时传入 --enable-libgme 即可启用。参见 https://bitbucket.org/mpyne/game-music-emu/overview。

1.10 Intel QuickSync Video

FFmpeg 可以使用 Intel QuickSync Video (QSV) 加速多种 codec 的解码和编码。要使用 QSV，FFmpeg 必须链接到 libmfx 分发库（负责加载实际的解码库）。

该分发库是开源的，可从 https://github.com/lu-zero/mfx_dispatch.git 下载。FFmpeg 需要使用 --enable-libmfx 选项进行配置，并且 pkg-config 必须能够定位到该分发库的 .pc 文件。

1.11 Kvazaar

FFmpeg 可以使用 Kvazaar 库进行 HEVC 编码。

访问 https://github.com/ultravideo/kvazaar 并按照说明安装该库，然后在 configure 时传入 --enable-libkvazaar 即可启用。

1.12 LAME

FFmpeg 可以使用 LAME 库进行 MP3 编码。

访问 http://lame.sourceforge.net/ 并按照说明安装该库，然后在 configure 时传入 --enable-libmp3lame 即可启用。

1.13 LCEVCdec

FFmpeg 可以使用 liblcevc_dec 库，对受支持的 bitstream 进行 LCEVC 增强层解码。

访问 https://github.com/v-novaltd/LCEVCdec 并按照说明安装该库，然后在 configure 时传入 --enable-liblcevc-dec 即可启用。

LCEVCdec 采用 BSD-3-Clause-Clear 许可证。

1.14 libilbc

iLBC 是一种窄带语音 codec，由 Google 作为 WebRTC 项目的一部分免费提供。libilbc 是 iLBC codec 的一个便于打包的副本。FFmpeg 可以使用 libilbc 库进行 iLBC 解码和编码。

访问 https://github.com/TimothyGu/libilbc 并按照说明安装该库，然后在 configure 时传入 --enable-libilbc 即可启用。

1.15 libjxl

JPEG XL 是一种图像格式，旨在长期内完全取代传统 JPEG。更多信息请参见 https://jpegxl.info/，库的源代码见 https://github.com/libjxl/libjxl。可以在 configure 时传入 --enable-libjxl 来启用 libjxl 包装器。

1.16 libvpx

FFmpeg 可以使用 libvpx 库进行 VP8/VP9 解码和编码。

访问 http://www.webmproject.org/ 并按照说明安装该库，然后在 configure 时传入 --enable-libvpx 即可启用。

1.17 ModPlug

FFmpeg 可以使用这个源自 Modplug-XMMS 的库来读取 MOD 类音乐文件。参见 https://github.com/Konstanty/libmodplug。在 configure 时传入 --enable-libmodplug 即可启用。

1.18 ONNX Runtime

FFmpeg 可以使用 ONNX Runtime 库作为基于 DNN 的滤镜的后端。

访问 https://onnxruntime.ai/ 并按照说明安装该库。多种平台都提供预编译好的软件包。

配置 FFmpeg 以启用 ONNX Runtime 支持：

./configure \
    --enable-libonnxruntime \
    --extra-cflags="-I/path/to/onnxruntime/include" \
    --extra-ldflags="-L/path/to/onnxruntime/lib"

在基于 ELF 的系统（Linux、BSD）上，你可能还希望嵌入库搜索路径，以便安装好的 ffmpeg 二进制文件在运行时无需设置 LD_LIBRARY_PATH 就能找到共享库：

./configure \
    --enable-libonnxruntime \
    --extra-cflags="-I/path/to/onnxruntime/include" \
    --extra-ldflags="-L/path/to/onnxruntime/lib -Wl,-rpath,/path/to/onnxruntime/lib"

-Wl,-rpath 标志是 ELF 特有的，在其他平台（Windows、macOS）上应当省略。

对于 MinGW GCC 构建，请添加 -D_stdcall=__stdcall 标志，以便与 ONNX Runtime 头文件兼容。

1.19 OpenCORE、VisualOn 与 Fraunhofer 库

OpenCore、VisualOn 和 Fraunhofer 库脱胎于 Google Android 的源码，为多种音频 codec 提供了 encoder。

OpenCORE 和 VisualOn 库采用 Apache License 2.0 授权（详见 http://www.apache.org/licenses/LICENSE-2.0），该许可证与 LGPL version 2.1 和 GPL version 2 不兼容。要使用它们，必须在 configure 时传入 --enable-version3，将 FFmpeg 的许可证升级为 LGPL version 3（如果已启用 GPL 组件，则为 GPL version 3）。

Fraunhofer AAC 库的许可证与 GPL 不兼容。因此，在 GPL 构建中使用它时，必须在 configure 时传入 --enable-nonfree。据我们所知，它与 LGPL 是兼容的。

1.19.1 OpenCORE AMR

FFmpeg 可以使用 OpenCORE 库进行 AMR-NB 的解码/编码，以及 AMR-WB 的解码。

访问 http://sourceforge.net/projects/opencore-amr/ 并按照说明安装这些库，然后在 configure 时传入 --enable-libopencore-amrnb 和/或 --enable-libopencore-amrwb 即可启用。

1.19.2 VisualOn AMR-WB encoder 库

FFmpeg 可以使用 VisualOn AMR-WBenc 库进行 AMR-WB 编码。

访问 http://sourceforge.net/projects/opencore-amr/ 并按照说明安装该库，然后在 configure 时传入 --enable-libvo-amrwbenc 即可启用。

1.19.3 Fraunhofer AAC 库

FFmpeg 可以使用 Fraunhofer AAC 库进行 AAC 解码和编码。

访问 http://sourceforge.net/projects/opencore-amr/ 并按照说明安装该库，然后在 configure 时传入 --enable-libfdk-aac 即可启用。

1.19.4 Fraunhofer MPEG-H 3D Audio decoder 库

FFmpeg 可以使用 Fraunhofer MPEG-H decoder 库进行 MPEG-H 3DA 解码。

访问 https://github.com/Fraunhofer-IIS/mpeghdec 并按照说明安装该库，然后在 configure 时传入 --enable-libmpeghdec --enable-nonfree 即可启用。

1.19.5 LC3 库

FFmpeg 可以使用 Google LC3 库进行 LC3 解码和编码。

访问 https://github.com/google/liblc3/ 并按照说明安装该库，然后在 configure 时传入 --enable-liblc3 即可启用。

1.20 OpenH264

FFmpeg 可以使用 OpenH264 库进行 H.264 解码和编码。

访问 http://www.openh264.org/ 并按照说明安装该库，然后在 configure 时传入 --enable-libopenh264 即可启用。

在解码方面，这个库比 libavcodec 内置的 decoder 局限得多；目前它还不支持 B 帧解码以及其他一些 main/high profile 特性（目前仅支持 constrained baseline profile 和 CABAC）。使用它主要适用于测试，以及借助 Cisco 的专利组合许可（http://www.openh264.org/BINARY_LICENSE.txt）。

1.21 OpenJPEG

FFmpeg 可以使用 OpenJPEG 库对 J2K 视频进行解码/编码。前往 http://www.openjpeg.org/ 获取该库并按照安装说明操作。要在 FFmpeg 中启用 OpenJPEG，请在 ./configure 时传入 --enable-libopenjpeg。

1.22 rav1e

FFmpeg 可以通过 C 绑定使用 rav1e（Rust AV1 Encoder）来编码视频。前往 https://github.com/xiph/rav1e/ 并按照说明构建 C 库。要在 FFmpeg 中启用 rav1e，请在 ./configure 时传入 --enable-librav1e。

1.23 SVT-AV1

FFmpeg 可以使用 Scalable Video Technology for AV1 库进行 AV1 编码。

访问 https://gitlab.com/AOMediaCodec/SVT-AV1/ 并按照说明安装该库，然后在 configure 时传入 --enable-libsvtav1 即可启用。

1.24 SVT-JPEG-XS

FFmpeg 可以使用 Scalable Video Technology for JPEG-XS 库进行 JPEG-XS 解码和编码。

访问 https://github.com/OpenVisualCloud/SVT-JPEG-XS 并按照说明安装该库，然后在 configure 时传入 --enable-libsvtjpegxs 即可启用。

1.25 TwoLAME

FFmpeg 可以使用 TwoLAME 库进行 MP2 编码。

访问 http://www.twolame.org/ 并按照说明安装该库，然后在 configure 时传入 --enable-libtwolame 即可启用。

1.26 VapourSynth

FFmpeg 可以将 VapourSynth 脚本作为输入读取。要启用支持，请在 configure 时传入 --enable-vapoursynth。Vapoursynth 通过 pkg-config 检测，支持 42 及以上版本。参见 http://www.vapoursynth.com/。

出于安全考虑，Vapoursynth 脚本不会被自动检测，因此必须强制指定输入格式。对于 ff* 系列命令行工具，请在输入 -i yourscript.vpy 之前加上 -f vapoursynth。

1.27 x264

FFmpeg 可以使用 x264 库进行 H.264 编码。

访问 http://www.videolan.org/developers/x264.html 并按照说明安装该库，然后在 configure 时传入 --enable-libx264 即可启用。

x264 采用 GNU Public License Version 2 或更高版本授权（详见 http://www.gnu.org/licenses/old-licenses/gpl-2.0.html），使用它需要将 FFmpeg 的许可证升级为 GPL。

1.28 x265

FFmpeg 可以使用 x265 库进行 HEVC 编码。

访问 http://x265.org/developers.html 并按照说明安装该库，然后在 configure 时传入 --enable-libx265 即可启用。

x265 采用 GNU Public License Version 2 或更高版本授权（详见 http://www.gnu.org/licenses/old-licenses/gpl-2.0.html），使用它需要将 FFmpeg 的许可证升级为 GPL。

1.29 xavs

FFmpeg 可以使用 xavs 库进行 AVS 编码。

访问 http://xavs.sf.net/ 并按照说明安装该库，然后在 configure 时传入 --enable-libxavs 即可启用。

1.30 xavs2

FFmpeg 可以使用 xavs2 库进行 AVS2-P2/IEEE1857.4 视频编码。

访问 https://github.com/pkuvcl/xavs2 并按照说明安装该库，然后在 configure 时传入 --enable-libxavs2 即可启用。

libxavs2 采用 GNU Public License Version 2 或更高版本授权（详见 http://www.gnu.org/licenses/old-licenses/gpl-2.0.html），使用它需要将 FFmpeg 的许可证升级为 GPL。

1.31 eXtra-fast Essential Video Encoder (XEVE)

FFmpeg 可以使用 XEVE 库进行 EVC 视频编码。

访问 https://github.com/mpeg5/xeve 并按照说明安装 XEVE 库，然后在 configure 时传入 --enable-libxeve 即可启用。

1.32 eXtra-fast Essential Video Decoder (XEVD)

FFmpeg 可以使用 XEVD 库进行 EVC 视频解码。

访问 https://github.com/mpeg5/xevd 并按照说明安装 XEVD 库，然后在 configure 时传入 --enable-libxevd 即可启用。

1.33 ZVBI

ZVBI 是一个 VBI 解码库，FFmpeg 可以用它来解码 DVB teletext 页面和 DVB teletext 字幕。

访问 http://sourceforge.net/projects/zapping/ 并按照说明安装该库，然后在 configure 时传入 --enable-libzvbi 即可启用。

2 支持的文件格式、codec 与特性

可以使用 -formats 和 -codecs 选项获取完整列表。

2.1 文件格式

FFmpeg 通过 libavformat 库支持以下文件格式：

X 表示该列（编码/解码）所对应的功能受支持。

2.2 图像格式

FFmpeg 可以为视频序列中的每一帧读写图像。支持以下图像格式：

X 表示该列（编码/解码）所对应的功能受支持。

E 表示该支持通过外部库提供。

2.3 视频 codec

X 表示该列（编码/解码）所对应的功能受支持。

E 表示该支持通过外部库提供。

2.4 音频 codec

X 表示该列（编码/解码）所对应的功能受支持。

E 表示该支持通过外部库提供。

I 表示还提供仅使用整数运算的版本（可确保在没有硬件浮点运算支持的系统上也能获得较高性能）。

2.5 字幕格式

X 表示支持该功能。

E 表示该支持通过外部库提供。

2.6 网络协议

X 表示支持该协议。

E 表示该支持通过外部库提供。

2.7 输入/输出设备

X 表示支持输入/输出。

2.8 时间码

主机托管由 telepoint.bg 提供