FVP
一个用于官方 Flutter Video Player 的插件,支持所有桌面和移动平台,具有硬件加速解码和最佳渲染功能。基于 libmdk。除了官方的 video_player
,你还可以使用后端播放器 API创建自己的播放器。
可以从 GitHub Actions 的构建产物中下载预构建的示例。
项目使用以下命令创建:flutter create -t plugin --platforms=linux,macos,windows,android,ios -i objc -a java fvp
特性
- 支持所有平台:Windows x64(包括 Win7)和 arm64、Linux x64 和 arm64、macOS、iOS、Android。
- 可以选择使用官方实现或本插件的实现
- 最佳渲染 API:Windows 使用 D3D11,macOS/iOS 使用 Metal,Linux 和 Android 使用 OpenGL(支持 Impeller)
- 默认启用硬件解码器
- 所有平台支持杜比视界
- 对现有 Video Player 应用只需最小的代码修改
- 通过 FFmpeg 解复用器和软件解码器支持大多数格式(如果 GPU 不支持)。你可以通过移除捆绑的 FFmpeg 动态库来使用自己的 FFmpeg 4.0~7.0(或主分支)。
- 高性能。相比基于 libmpv 的播放器,CPU、GPU 和内存负载更低。
- 支持纯音频播放
- 体积小。每个 CPU 架构仅增加约 10MB 大小(取决于平台)。
使用方法
- 在你的 pubspec.yaml 依赖项中添加 fvp:
flutter pub add fvp
- 在你的 video_player 示例中添加 2 行代码。对于官方 video_player 不支持的平台(即 Windows 和 Linux),这是可选的(自 v0.16.0 起)
import 'package:fvp/fvp.dart';
registerWith(); // 在 main() 中,或在创建播放器之前的任何位置
然后,所有平台都将使用此插件实现。如果没有这些行,将使用官方实现(如果存在)。你还可以选择启用 fvp 实现的平台
registerWith(options: {'platforms': ['windows', 'macos', 'linux']}); // 只有这些平台会使用此插件实现
要选择其他解码器,请这样传递选项
registerWith(options: {
'video.decoders': ['D3D11', 'NVDEC', 'FFmpeg']
//'lowLatency': 1, // 网络流可选
}); // Windows
文档列出了 registerWith()
的所有选项
后端播放器 API
import 'package:fvp/mdk.dart';
该插件通过 player.dart 的薄封装实现了 VideoPlayerPlatform。
现在我们还公开了这个后端播放器 API,因此你可以轻松创建自己的播放器,并获得比官方 video_player 更多的功能,例如,从给定位置播放、在特定范围内循环、选择解码器、详细的媒体信息等。你还可以重复使用 Player 实例而无需无条件地创建和销毁,只需更改 Player.media
即可。
这是一个示例
手动升级依赖项
升级二进制依赖项可以带来新功能和后端错误修复。对于 macOS 和 iOS,在你的项目目录中运行
pod cache clean mdk
find . -name Podfile.lock -delete
rm -rf {mac,i}os/Pods
对于其他平台,设置环境变量 FVP_DEPS_LATEST=1
并重新构建,将升级到最新的 SDK。如果从 pub.dev 安装了 fvp,运行 flutter pub cache clean
是另一种选择。
设计
- 通过 FFI 在 Dart 中实现播放控制 API
- 以平台特定的方式管理视频渲染器。通过
MethodChannel
接收播放器指针以构造播放器实例并设置渲染器目标。 - C++ 中的回调和事件通过 ReceivePort 通知
- 具有一次性回调的函数是异步的,并返回一个 Future
启用字幕
需要 libass,它会自动添加到你的 Windows、macOS 和 Android 应用程序中(如果不需要,请从 mdk-sdk 中删除 ass.dll、libass.dylib 和 libass.so)。对于 iOS,下载并将 ass.framework
添加到你的 Xcode 项目中。对于 Linux,可以使用系统的 libass,你可能需要通过系统包管理器手动安装。
如果系统中找不到所需的字幕字体(例如 Android),你可以在 pubspec.yaml 中添加 assets/subfont.ttf 作为备用。
不要使用 flutter-snap
Flutter 可以通过 snap 安装,但它会添加一些可能破坏 C++ 编译器的环境变量(CPLUS_INCLUDE_PATH
和 LIBRARY_PATH
)。不建议使用 snap,尽管 Linux 的构建问题已经修复,但 Android 仍无法解决。
截图