安装


fplayer 是 fijkplayer 的 Flutter 封装, 是一款支持 android 和 iOS 的 Flutter 媒体播放器插件, 由 ijkplayeropen in new window 底层驱动。
通过纹理(Texture)接入播放器视频渲染到 Flutter 中。

让我们开始使用 fplayer 构建你的 Flutter 音视频应用之旅!
别担心,只需要掌握很少的知识你就能完成 Flutter 音视频应用的开发。

本节内容包括简洁安装指南以及详细安装指南。

简洁安装指南

在 flutter 项目配置文件 pubspec.yaml 中加入 fplayer 依赖。最新的稳定版本号见 badge 图标。

dependencies:
  fplayer: ^{latest verison}

pub packageopen in new window    

{latest verison} 使用徽标中的版本号代替。

如果需要使用某些尚未发布的功能更新,可以直接依赖对应的 git 分支,方式如下。 比如这里依赖 develop 分支,

dependencies:
  fplayer:
    git:
      url: https://github.com/FlutterPlayer/fplayer.git
      ref: develop

详细安装步骤

如果你熟悉 Flutter App 的依赖安装,看上面 “简洁安装指南” 就够了,本页后续内容完全可以跳过。

如果你不太熟悉 Flutter App 开发流程,看到了这这一部分内容,我们还是假定你已经在你的设备上配置好了 Flutter 的开发环境。即你可以在命令行输入 flutter 命令,并且有相应的正确输出内容。

新建 Flutter App 项目

终端输入以下命令,新建一个名为 playerapp 的 Flutter App 项目。

$ flutter create -t app playerapp

命令运行结束后,Flutter 会给我们如下提示。

In order to run your application, type:

  $ cd playerapp
  $ flutter run

Your application code is in playerapp/lib/main.dart.

连接上手机设备(或者打开 Android 模拟器),并且使用 flutter doctor 命令检查设备是否连接成功。

$ flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, v1.7.8+hotfix.4, on Mac OS X 10.14.3 18D109, locale zh-Hans-CN)

[✓] Android toolchain - develop for Android devices (Android SDK version 28.0.3)
[✓] Xcode - develop for iOS and macOS (Xcode 10.3)
[✓] iOS tools - develop for iOS devices
[✓] Android Studio (version 3.4)
[✓] IntelliJ IDEA Ultimate Edition (version 2019.1.2)
[✓] VS Code (version 1.36.1)
[✓] Connected device (1 available)

• No issues found!

flutter doctor 命令的输出中,至少应该含有 [✓] Connected device (1 available)

安装 fplayer 依赖

进入上一步中创建的目录 playerapp 中,编辑其中的文件 pubspec.yaml ,增加依赖 fplayer: ^{latest verison}

dependencies:
  flutter:
    sdk: flutter
    
+ fplayer: ^{latest verison}

pub packageopen in new window    

{latest verison} 使用徽标中的版本号代替。

然后在 playerapp 目录中运行如下命令安装依赖,等待命令成功完成。

$ flutter pub get --verbose

验证依赖安装

安装完 fplayer 之后我们先验证一下,确保安装正确。

编辑 lib/main.dart 文件,在开头加入如下行,引入 fplayer。

import 'package:fplayer/fplayer.dart';

然后分别编译 ios 和 android 项目,确保 build 成功

$ flutter build apk
$ flutter build ios --no-codesign

注意事项

  • fplayer 中使用了 androidx 的 support 库,在 app 中需要启用 androidx
  • 如果 build apk 时太久时间没有输出,可以先在 android 目录运行 ./gradlew 检查 gradle 环境是否正确。
  • pod install 安装依赖需要从 github 下载底层 ijkplayer 的二进制文件,如果网不好可能会很慢。
    建议在 ios 文件夹中运行 pod install --verbose 查看实时下载进度。
  • ios可调试环境:flutter 3.3.10、xcode 14.2

Flutter 中安装 fplayer 的内容到这里就结束了,有任何问题请在 github issuesopen in new window 中进行提问。