FFmpegKit
是一系列工具的集合,用于在Android
、iOS
、Linux
、macOS
、tvOS
、Flutter
和React Native
应用程序中使用FFmpeg
。
它包括用于构建FFmpeg
原生库的脚本,一个在应用程序中运行FFmpeg
/FFprobe
命令的封装库,以及8个预构建的二进制包,可在Github、Maven Central、CocoaPods、pub和npm上获取。
FFmpegKit
封装库,用于在应用程序中运行FFmpeg
/FFprobe
命令v4.5-dev
或更高版本,可选择系统和外部库LGPL 3.0
许可,如果启用了GPL许可的库,则采用GPL v3.0
许可查看Android以了解更多关于Android
平台FFmpegKit
的信息。
查看Apple以在Apple
平台(iOS
、macOS
、tvOS
)上使用FFmpegKit
。
查看Flutter以了解更多关于Flutter
平台FFmpegKit
的信息。
查看Linux以了解更多关于Linux
平台FFmpegKit
的信息。
查看React Native以了解更多关于React Native
平台FFmpegKit
的信息。
使用android.sh
、ios.sh
、linux.sh
、macos.sh
和tvos.sh
为每个原生平台构建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在功能和能力上是相同的。
在Github、Maven Central、CocoaPods、pub和npm上分发了八种不同的ffmpeg-kit
包。
下面你可以看到每个包中启用了哪些系统库和外部库。
请记住,FFmpeg
的某些部分采用GPL
许可,只有采用GPL
许可的ffmpeg-kit
包才包含这些部分。
生成的 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日 |
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 |
更详细的文档可在Wiki下获得。
你可以通过运行在FFmpegKit Test项目下创建的测试应用来了解FFmpegKit
在应用内的使用方式。
所有应用都是相同的,支持命令执行、视频编码、访问https网址、音频编码、烧录字幕、视频稳定、管道操作和并发命令执行。
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
文档中使用的商标。
虽然在他们的文档中没有明确解释,但据信FFmpeg
、kvazaar
、x264
和x265
包含受软件专利保护的算法。如果你生活在软件算法可申请专利的国家,那么你可能需要向专利持有人支付版税。不过我们不是律师,所以我们建议你先寻求法律意见。请参阅FFmpeg专利迷你FAQ。
openh264
明确指出它使用专利算法。因此,如果你使用openh264
构建ffmpeg-kit
并分发该库,那么你需要支付MPEG LA许可费。详情请参阅OpenH264常见问题页面。
请参阅我们的贡献指南。