本文为您介绍集成 Flutter 播放器 SDK 的环境要求和具体操作步骤。

开发环境

• Flutter 版本：Flutter stable channel 3.0.0 及以上版本
• Dart 版本：Dart 2.17.0 及以上版本
• 系统要求：
  • iOS 11.0 及以上版本
  • Android 4.1 及以上版本（minSdkVersion: 16），要求 armv7 或 arm64 架构

  注意

  推荐使用真机测试。模拟器可能存在功能缺失或者性能问题。

• 开发工具：推荐使用 Visual Studio Code 或 Android Studio 最新版本

获取 License

视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。在项目测试阶段，您可以在视频点播控制台申请免费的测试 License。您需完成以下操作：

• 创建应用
• 申请免费测试 License
• 绑定 License 与应用

项目结构说明

Flutter SDK 的项目结构如下：

├── CHANGELOG.md
├── LICENSE
├── README.md
├── analysis_options.yaml
├── android
├── example
├── ios
├── lib
├── pubspec.lock
├── pubspec.yaml
└── vod_player_flutter.iml

关键文件夹及说明如下表所示。

集成步骤

步骤 1：添加依赖

Flutter SDK 支持两种依赖方式：远程依赖和本地依赖。

（推荐）方式一：远程依赖

1. 在终端中进入您的 Flutter 项目根目录，运行如下命令安装对应版本的依赖项：

   说明

   请参见发布历史获取 SDK 最新版本号。

   flutter pub add ve_vod:^x.x.x
   

2. 根据您集成的版本，在项目的 pubspec.yaml 文件中添加不同的代码：

   基础版

   高级版

   如集成基础版，请添加以下代码：

   ve_vod:
     sub_spec: standard
   

   如集成高级版或企业版，请添加以下代码：

   ve_vod:
     sub_spec: premium
   

运行完毕后，pubspec.yaml 文件中会新增下列一行代码：

dependencies:
    ve_vod: <SDK_VERSION>

方式二：本地依赖

1. 前往下载页面，下载最新版本的 SDK 包至本地，并解压。
2. 将 SDK 文件夹复制到你的项目文件夹下。
3. 在 pubspec.yaml 文件中添加 ve_vod 依赖项，如下所示：

   dependencies:
       flutter:
           sdk: flutter
       # 将 <SDK_PATH> 替换为项目下 SDK 的文件路径
       ve_vod: 
           path: <SDK_PATH>
   

步骤 2：平台配置

为 Android 和 iOS 分别进行相应配置：

Android

需添加 maven 仓库 、Java 8 支持、权限声明和混淆规则，具体请参考 Android SDK 集成文档。

iOS

1. 关闭 Bitcode，具体请参考 iOS SDK 集成文档。
2. 配置 Pod Source。请在您的 Xcode 工程的 Podfile 文件中添加以下 Source：

   source 'https://github.com/volcengine/volcengine-specs.git'
   

步骤 3：添加 License 文件

将您获取到的 License 文件拖入您 Flutter 工程的assets 目录下。后续在初始化 SDK 时您需要传入 License 文件路径。路径示例：

assets
└── VEVod.lic

后续操作

至此，您已完成播放器 SDK 的集成。下面演示如何使用播放器 SDK 播放视频。详情请见基础功能。