本文为您介绍集成 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 与应用，详细操作步骤，请见应用管理和播放器 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：远程依赖

1. 根据您集成的版本，手动配置需添加不同的代码：

   基础版

   高级版

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

   ve_vod:
     sub_spec: standard
   

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

   ve_vod:
     sub_spec: premium
   

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

   说明

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

   flutter pub add ve_vod:^<请替换为最新版本号>
   

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

   dependencies:
       ve_vod: <SDK_VERSION>
   

方式 2：本地依赖

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

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

步骤 2：平台配置 #

为了确保播放器 SDK 在 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 播放视频。详情请见基础功能。

常见问题 #

我的视频存储在视频点播的海外柔佛地域，需要特殊配置吗？ #

当您的业务接入海外柔佛地域时，需要对播放器 SDK 进行专门的地域配置，主要涉及以下两个环节：

• 配置海外日志上报通道：修改 pubspec.yaml 文件，确保海外用户的播放日志从海外渠道进行上报。
• 指定海外业务服务地域：在初始化 SDK 时，通过 appRegion 参数，明确指定视频资源所在的海外服务地域。

详细的操作步骤，请参见服务地域文档中的播放器 SDK章节。