FFmpeg-Kit实战指南：三步搞定跨平台音视频处理

FFmpeg-Kit实战指南三步搞定跨平台音视频处理【免费下载链接】ffmpeg-kitFFmpeg Kit for applications. Supports Android, Flutter, iOS, Linux, macOS, React Native and tvOS. Supersedes MobileFFmpeg, flutter_ffmpeg and react-native-ffmpeg.项目地址: https://gitcode.com/GitHub_Trending/ff/ffmpeg-kitFFmpeg-Kit是一个基于FFmpeg的跨平台音视频处理工具集覆盖Android、iOS、Linux、macOS、tvOS及Flutter、React Native等跨平台框架。8种FFmpeg预构建包让移动端转码集成只需三步。 一页读懂FFmpeg-KitFFmpeg-Kit做了两件事。一是位于scripts/目录下的一整套交叉编译FFmpeg原生库的构建脚本每个平台一个入口二是其上的封装库向应用暴露统一的FFmpeg/FFprobe执行API。相比直接集成原生FFmpeg你不需要管理NDK工具链、手改configure配置或逐个架构处理ABI只需引入预构建包再传入一条命令字符串。每次execute调用都会产生一个Session对象返回码、日志、耗时和实时统计在所有平台上都能从它统一读取排查问题比直接盯原始进程输出容易得多。Flutter与React Native包基于FFmpeg 6.0原生平台包基于FFmpeg v4.5-dev及以上。平台API硬件加速/系统库最低要求AndroidJavaMediaCodec硬编解码API 24LTS降至16iOSObjective-CVideoToolbox、AudioToolbox、AVFoundationSDK 12.1LTS降至10macOSObjective-CVideoToolbox、AVFoundation、OpenCL/OpenGL10.15tvOSObjective-CVideoToolbox、AudioToolbox无AVFoundation11.0LinuxCC11VAAPI、V4L2需自行构建x86_64FlutterDart复用底层Android/iOS/macOS能力随宿主平台React NativeJavaScript含TS定义复用Android/iOS能力随宿主平台 选对构建包8种预构建包的区别在于启用了哪些外部库这直接决定了你能编码哪些编解码器以及产物的许可证。使用场景推荐包许可证影响基础转封装、媒体探测、包体最小minLGPL v3零外部依赖H.264/H.265/Xvid编码、视频防抖min-gpl整个包升级为GPL v3HTTPS/安全流媒体访问httpsLGPL v3含gmp、gnutlsMP3、Opus、AMR等音频转码audioLGPL v3含lame、opus、soxrVP8/VP9、AV1、WebP、字幕渲染videoLGPL v3含libvpx、dav1d、zimg、libass全部LGPL范围内功能fullLGPL v3全功能且需要GPL编码器full-gpl整个包为GPL v3vid.stab、x264、x265、xvidcore这4个GPL库只存在于带-gpl后缀的包中一旦启用整包许可从LGPL v3切换为GPL v3。建议先用min或https起步确认真需要x264或x265时再换-gpl包并先与法务确认分发合规。⚡ 从安装到第一次转码Android在build.gradle里加一行依赖即可// 按需替换 min / https / full 等包名 implementation com.arthenica:ffmpeg-kit-full:6.0Flutter在pubspec.yaml加一行默认安装https包其他包形如ffmpeg_kit_flutter_包名# pubspec.yaml ffmpeg_kit_flutter: 6.0.3React Native用包管理器安装iOS端还需在Podfile中以subspec指定包yarn add ffmpeg-kit-react-native下面是一条能完整跑通的最小转码用内置mpeg4编码器重编码MP4不依赖任何外部库若要用libx264请先换min-gpl或full-gpl包。import { FFmpegKit, ReturnCode } from ffmpeg-kit-react-native; FFmpegKit.execute(-i in.mp4 -c:v mpeg4 out.mp4).then(async (s) { // 检查执行结果 console.log(ReturnCode.isSuccess(await s.getReturnCode())); }); 高频用法速查命令模式用途-i in.mov -c:v libx264 -crf 28 -c:a aac out.mp4视频压缩需gpl包-i in.mkv -c copy out.mp4容器转换不重编码速度最快-i in.mp4 -vf scale1280:720 out.mp4降分辨率-ss 00:00:10 -t 5 -i in.mp4 out.mp4截取5秒片段-i in.mp4 -vn -c:a libopus out.opus抽取音轨并转码需audio包-re -i rtmp://src/live -c copy -f flv rtmp://dst/liveRTMP直播流转发ffprobe -show_format -show_streams in.mp4探测时长、码率与流信息以上参数直接拼成字符串传给execute即可无需了解FFmpeg内部实现。 平台适配与硬件加速AndroidJavaMediaCodec硬编解码支持SAF Uris最低API 24LTS包降到16。iOSObjective-CVideoToolbox、AudioToolbox、AVFoundation以XCFramework分发LTS包放弃VideoToolbox与AVFoundation。macOSObjective-CVideoToolbox、AVFoundation外加OpenCL/OpenGLarm64与x86-64双架构。tvOSObjective-CVideoToolbox与AudioToolbox无AVFoundation。LinuxC支持VAAPI与V4L2但没有预构建二进制必须运行linux.sh自行编译。FlutterDart一套Dart API覆盖Android、iOS、macOS三个宿主。React NativeJavaScript自带TypeScript定义Android与iOS双端支持。️ 进阶调优异步执行用executeAsync避免阻塞主线程完成、日志、统计三个回调各司其职。线程数命令串加-threads N控制并发移动端建议2以下防止发热降频。日志与统计回调按会话粒度触发事后可用session的getLogs()、getStatistics()回查。// 异步执行 实时统计 FFmpegKit.executeAsync(cmd, session - { // 完成回调session.getReturnCode() }, log - { // 处理日志行 }, statistics - { // 监控进度getBitrate()、getVideoFps() }); 避坑指南GPL边界默认包为LGPL v3-gpl后缀包含x264、x265、xvidcore、vid.stab整包切换为GPL v3商业闭源分发需重点评估。编解码器专利FFmpeg、x264、x265、kvazaar据信涉及软件专利openh264明确使用专利算法分发需向MPEG LA付费上线前请咨询法务。维护现状官方项目已停止维护原作者以FFmpegKitNext作为延续社区在Maven Central、pub.dev、npm上各有fork。最后发布的Flutter包为6.0.32023-09React Native为6.0.2项目若要求持续维护应评估新版。需要移动端转码且LGPL包够用的团队FFmpeg-Kit预构建包仍是稳妥基线追求新版FFmpeg、活跃维护或闭源商用必须用GPL编码器的请转向社区分支或自行构建。【免费下载链接】ffmpeg-kitFFmpeg Kit for applications. Supports Android, Flutter, iOS, Linux, macOS, React Native and tvOS. Supersedes MobileFFmpeg, flutter_ffmpeg and react-native-ffmpeg.项目地址: https://gitcode.com/GitHub_Trending/ff/ffmpeg-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考