You need to enable JavaScript to run this app.
导航
集成 SDK
最近更新时间:2024.07.03 17:48:25首次发布时间:2024.05.22 11:52:36

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

环境要求

  • Flutter 版本:Flutter stable channel 3.0.0 及以上版本
  • Dart 版本:Dart 2.17.0 及以上版本
  • 系统版本:
    • 支持 iOS 11.0 及以上版本
    • 支持 Android 4.1 及以上版本(minSdkVersion: 16
  • 开发工具:推荐使用 Visual Studio Code 或 Android Studio 最新版本

前提条件

集成 SDK 前,您需要在视频点播控制台完成以下操作:

  • 创建应用并获取 App ID。
  • 购买 License。
  • 绑定 License 与应用。
  • 下载 License 文件。

详情请见创建应用License 包管理

注意

测试版 License 不能在线上业务 App 使用,原因如下:

  • 测试版 License 仅供联调测试,到期后无法续期。
  • 测试版 License 到期会导致 App 鉴权不通过,从而影响业务使用。

项目结构说明

Flutter SDK 的项目结构如下:

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

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

文件夹

说明

是否必需

lib

Flutter 基于原生 SDK 开发的插件层。

android

Android 端原生代码与播放器 SDK。

ios

iOS 端原生代码与播放器 SDK。

example

Flutter 播放器 Demo。

集成步骤

添加依赖

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

(推荐)方式一:远程依赖

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

    说明

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

    flutter pub add ve_vod:^x.x.x
    
  2. 根据您集成的版本,在项目的 pubspec.yaml 文件中添加不同的代码:

    如集成基础版,请添加以下代码:

    ve_vod:
      sub_spec: standard
    

运行完毕后,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>
    

平台配置

为 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'
    

添加 License 文件

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

assets
└── VEVod.lic

注意

工程的 Bundle ID、Package ID、App ID 等需要与您在视频点播控制台申请 License 时传入的保持一致,否则会出现鉴权失败问题。

后续操作

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