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
包才包含这些部分。
最小 | 最小-GPL | HTTPS | HTTPS-GPL | 音频 | 视频 | 完整 | 完整-GPL | |
---|---|---|---|---|---|---|---|---|
外部库 | - | vid.stab x264 x265 xvidcore | gmp gnutls | gmp gnutls vid.stab x264 x265 xvidcore | lame libilbc libvorbis opencore-amr opus shine soxr speex twolame vo-amrwbenc | dav1d fontconfig freetype fribidi kvazaar libass libiconv libtheora libvpx libwebp snappy zimg | 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 | 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 |
Android系统库 | zlib MediaCodec | |||||||
iOS系统库 | bzip2 AudioToolbox AVFoundation iconv VideoToolbox zlib | |||||||
macOS系统库 | bzip2 AudioToolbox AVFoundation Core Image iconv OpenCL OpenGL VideoToolbox zlib | |||||||
tvos系统库 | bzip2 AudioToolbox iconv VideoToolbox zlib |
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 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 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 Apple | 4.5 | 4.5-dev-2008 | 2021年9月18日 |
Android 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 arm64-v8a x86 x86-64 | arm-v7a arm-v7a-neon arm64-v8a x86 x86-64 |
iOS最低SDK | 12.1 | 10 |
iOS VideoToolbox | 是 | - |
iOS AVFoundation | 是 | - |
iOS架构 | arm64 arm64-simulator arm64-mac-catalyst x86-64 x86-64-mac-catalyst | armv7 arm64 i386 x86-64 |
iOS包格式 | XCFrameworks | Frameworks |
Mac Catalyst最低版本 | 14.0 | - |
macOS最低SDK | 10.15 | 10.12 |
macOS AVFoundation | 是 | - |
macOS架构 | arm64 x86-64 | x86-64 |
macOS包格式 | XCFrameworks | Frameworks |
tvOS最低SDK | 11.0 | 10.0 |
tvOS VideoToolbox | 是 | - |
tvOS架构 | arm64 x86-64 arm64-simulator | arm64 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
文档中使用的商标。
15. 专利
虽然在他们的文档中没有明确解释,但据信FFmpeg
、kvazaar
、x264
和x265
包含受软件专利保护的算法。如果你生活在软件算法可申请专利的国家,那么你可能需要向专利持有人支付版税。不过我们不是律师,所以我们建议你先寻求法律意见。请参阅FFmpeg专利迷你FAQ。
openh264
明确指出它使用专利算法。因此,如果你使用openh264
构建ffmpeg-kit
并分发该库,那么你需要支付MPEG LA许可费。详情请参阅OpenH264常见问题页面。
16. 贡献
请参阅我们的贡献指南。