FFmpegKit

FFmpegKit是一系列工具的集合，用于在Android、iOS、Linux、macOS、tvOS、Flutter和React Native应用程序中使用FFmpeg。

它包括用于构建FFmpeg原生库的脚本，一个在应用程序中运行FFmpeg/FFprobe命令的封装库，以及8个预构建的二进制包，可在Github、Maven Central、CocoaPods、pub和npm上获取。

1. 特性

用于构建FFmpeg原生库的脚本
FFmpegKit封装库，用于在应用程序中运行FFmpeg/FFprobe命令
支持原生平台：Android、iOS、Linux、macOS和tvOS
支持混合平台：Flutter、React Native
基于FFmpeg v4.5-dev或更高版本，可选择系统和外部库
8个预构建的二进制包可在Github、Maven Central、CocoaPods、pub和npm上获取
默认采用LGPL 3.0许可，如果启用了GPL许可的库，则采用GPL v3.0许可

2. Android

查看Android以了解更多关于Android平台FFmpegKit的信息。

3. iOS、macOS、tvOS

查看Apple以在Apple平台（iOS、macOS、tvOS）上使用FFmpegKit。

4. Flutter

查看Flutter以了解更多关于Flutter平台FFmpegKit的信息。

5. Linux

查看Linux以了解更多关于Linux平台FFmpegKit的信息。

6. React Native

查看React Native以了解更多关于React Native平台FFmpegKit的信息。

7. 构建脚本

使用android.sh、ios.sh、linux.sh、macos.sh和tvos.sh为每个原生平台构建FFmpegKit。

所有脚本都支持额外的选项来启用可选库和禁用平台架构。详情请参阅构建维基页面。

8. FFmpegKit库

FFmpegKit是一个封装库，允许你在应用程序中轻松运行FFmpeg/FFprobe命令。它在FFmpeg的基础上提供了额外的功能，以启用平台特定的资源，控制命令的执行方式以及结果的处理方式。

FFmpegKit的Android库提供Java API，Apple库（iOS、macOS、tvOS）提供Objective-C API，Flutter库提供Dart API，Linux库提供C++ API，React Native库提供带有Typescript定义的JavaScript API，这些API在功能和能力上是相同的。

9. 包

在Github、Maven Central、CocoaPods、pub和npm上分发了八种不同的ffmpeg-kit包。下面你可以看到每个包中启用了哪些系统库和外部库。

请记住，FFmpeg的某些部分采用GPL许可，只有采用GPL许可的ffmpeg-kit包才包含这些部分。

<table> <thead> <tr> <th align="center"></th> <th align="center">最小</th> <th align="center">最小-GPL</th> <th align="center">HTTPS</th> <th align="center">HTTPS-GPL</th> <th align="center">音频</th> <th align="center">视频</th> <th align="center">完整</th> <th align="center">完整-GPL</th> </tr> </thead> <tbody> <tr> <td align="center">外部库</td> <td align="center">-</td> <td align="center">vid.stab x264 x265 xvidcore</td> <td align="center">gmp gnutls</td> <td align="center">gmp gnutls vid.stab x264 x265 xvidcore</td> <td align="center">lame libilbc libvorbis opencore-amr opus shine soxr speex twolame vo-amrwbenc</td> <td align="center">dav1d fontconfig freetype fribidi kvazaar libass libiconv libtheora libvpx libwebp snappy zimg</td> <td align="center">dav1d fontconfig freetype fribidi gmp gnutls kvazaar lame libass libiconv libilbc libtheora libvorbis libvpx libwebp libxml2 opencore-amr opus shine snappy soxr speex twolame vo-amrwbenc zimg</td> <td align="center">dav1d fontconfig freetype fribidi gmp gnutls kvazaar lame libass libiconv libilbc libtheora libvorbis libvpx libwebp libxml2 opencore-amr opus shine snappy soxr speex twolame vid.stab vo-amrwbenc x264 x265 xvidcore zimg</td> </tr> <tr> <td align="center">Android系统库</td> <td align="center" colspan=8>zlib MediaCodec</td> </tr> <tr> <td align="center">iOS系统库</td> <td align="center" colspan=8>bzip2 AudioToolbox AVFoundation iconv VideoToolbox zlib</td> </tr> <tr> <tr> <td align="center">macOS系统库</td> <td align="center" colspan=8>bzip2 AudioToolbox AVFoundation Core Image iconv OpenCL OpenGL VideoToolbox zlib</td> </tr> <tr> <td align="center">tvos系统库</td> <td align="center" colspan=8>bzip2 AudioToolbox iconv VideoToolbox zlib</td> </tr> </tbody> </table> - `AVFoundation` 在 `tvOS` 上不可用 - `VideoToolbox` 在 `iOS` 和 `tvOS` 的 LTS 版本中不可用 - 自 `v4.5.1` 开始支持 `zimg`

10. 版本

生成的 FFmpegKit 二进制文件使用与上游 FFmpeg 项目相同的主要和次要版本号。版本字符串中的第三个和最后一个数字（如果存在）是 FFmpegKit 特有的。它表示来自同一 FFmpeg 发布分支的不同发布。

版本字符串中的 dev 部分表示 FFmpeg 源代码是从 FFmpeg 的 master 分支克隆的，并且使用 git describe --tags 命令获得了 FFmpeg 的确切版本号。

平台	FFmpegKit 版本	FFmpeg 版本	发布日期
Flutter	6.0.3	6.0	2023年9月19日
React Native	6.0.2	6.0	2023年9月19日
Flutter	6.0.2	6.0	2023年9月3日
React Native	6.0.1	6.0	2023年9月3日
Flutter	6.0.1	6.0	2023年9月3日
React Native	6.0.0	6.0	2023年8月27日
Flutter	6.0.0	6.0	2023年8月27日
Android<br>Apple	6.0	6.0	2023年8月21日
React Native	5.1.0	5.1.2	2022年10月2日
Flutter	5.1.0	5.1.2	2022年10月2日
Android<br>Apple	5.1	5.1.2	2022年9月29日
React Native	4.5.2	4.5-dev-3393	2022年5月25日
Flutter	4.5.1	4.5-dev-3393	2022年1月2日
React Native	4.5.1	4.5-dev-3393	2022年1月2日
Android	4.5.1	4.5-dev-3393	2022年1月1日
Apple	4.5.1	4.5-dev-3393	2021年12月30日
Flutter	4.5.0	4.5-dev-2008	2021年10月5日
React Native	4.5.0	4.5-dev-2008	2021年10月1日
Android<br>Apple	4.5	4.5-dev-2008	2021年9月18日
Android<br>Apple	4.4	4.4-dev-3015	2021年3月3日

11. LTS 发布

FFmpegKit 二进制文件以两种发布变体发布：主要发布 和 LTS 发布。

主要版本包含库的完整功能,并支持最新的SDK/API特性。
LTS版本定制以支持更广泛的设备。它们使用较旧的API/SDK版本构建,因此某些功能在这些版本中不可用。

下表显示了两种变体之间的差异。

	主要版本	LTS版本
Android API级别	24	16
Android相机访问	是	-
Android架构	arm-v7a-neon<br/>arm64-v8a<br/>x86<br/>x86-64	arm-v7a<br/>arm-v7a-neon<br/>arm64-v8a<br/>x86<br/>x86-64
iOS最低SDK	12.1	10
iOS VideoToolbox	是	-
iOS AVFoundation	是	-
iOS架构	arm64<br/>arm64-simulator<br/>arm64-mac-catalyst<br/>x86-64<br/>x86-64-mac-catalyst	armv7<br/>arm64<br/>i386<br/>x86-64
iOS包格式	XCFrameworks	Frameworks
Mac Catalyst最低版本	14.0	-
macOS最低SDK	10.15	10.12
macOS AVFoundation	是	-
macOS架构	arm64<br/>x86-64	x86-64
macOS包格式	XCFrameworks	Frameworks
tvOS最低SDK	11.0	10.0
tvOS VideoToolbox	是	-
tvOS架构	arm64<br/>x86-64<br/>arm64-simulator	arm64<br/>x86-64
tvOS包格式	XCFrameworks	Frameworks

12. 文档

更详细的文档可在Wiki下获得。

13. 测试应用

你可以通过运行在FFmpegKit Test项目下创建的测试应用来了解FFmpegKit在应用内的使用方式。

所有应用都是相同的,支持命令执行、视频编码、访问https网址、音频编码、烧录字幕、视频稳定、管道操作和并发命令执行。

14. 许可证

FFmpegKit库本身使用LGPL v3.0许可。

FFmpegKit捆绑包(.aar档案、frameworks、xcframeworks),包括FFmpegKit和FFmpeg库,也使用LGPL v3.0许可。但是,如果使用可选的--enable-gpl标志构建源代码,或使用带有-gpl后缀的预构建二进制文件,则FFmpegKit捆绑包将受GPL v3.0约束。因为在这些捆绑包中,FFmpeg使用GPL v3.0许可。这使得整个捆绑包实际上受GPL v3.0约束。

FFmpegKit构建脚本始终使用--enable-version3选项配置FFmpeg。并且从不启用非自由库。因此,FFmpegKit创建的FFmpeg库默认使用LGPL v3.0许可。只有在提供--enable-gpl时,它们才会受GPL v3.0约束。这就是带有-gpl后缀的预构建二进制文件的编译方式。

参阅许可证以查看所有库的许可证。商标列出了FFmpegKit文档中使用的商标。