# 2-快速集成

* [1 账号准备](#1-账号准备)
* [2 环境要求](#2-环境要求)
* [3 集成播放器项目](#3-集成播放器项目)
  * [3.1 导入通用模块](#31-导入通用模块)
  * [3.2 导入长视频场景模块](#32-导入长视频场景模块)
  * [3.3 导入短视频场景模块](#33-导入短视频场景模块)
  * [3.4 配置播放器 SDK](#34-配置播放器-sdk)
  * [3.5 跳转播放页面](#35-跳转播放页面)
  * [3.6 参数修改](#36-参数修改)

#### 1 账号准备

在集成播放器 SDK 项目之前，请先在[Polyv 官网](http://www.polyv.net/)注册账号，并开通云点播服务。

为了播放您账号下的点播视频，播放器将需要使用到您点播系统中的`userId`和`secretKey`，您可以登录点播后台，在[API 接口](https://my.polyv.net/secure/setting/api)中获取参数。

#### 2 环境要求

| 名称                   | 要求            |
| -------------------- | ------------- |
| compatibleSdkVersion | >= 5.0.0(12)  |
| abiFilters           | 仅支持 arm64-v8a |

#### 3 集成播放器项目

**3.1 导入通用模块**

拷贝 demo 项目中的`common`模块到您项目的根目录下，并修改项目的`build-profile.json5`文件，添加对 common 模块的引用：

```json5
{
  "name": "common",
  "srcPath": "./common"
}
```

**3.2 导入长视频场景模块**

拷贝 demo 项目中的`scene_single_video`模块到您项目的根目录下，并修改项目的`build-profile.json5`文件，添加对长视频场景模块的引用：

```json5
{
  "name": "scene_single_video",
  "srcPath": "./scene_single_video"
}
```

**3.3 导入短视频场景模块**

拷贝 demo 项目中的`scene_feed_video`模块到您项目的根目录下，并修改项目的`build-profile.json5`文件，添加对短视频场景模块的引用：

```json5
{
  "name": "scene_feed_video",
  "srcPath": "./scene_feed_video"
}
```

**3.4 配置播放器 SDK**

在配置播放器 SDK 之前，需要修改模块的`oh-package.json5`文件，添加播放器 SDK 的依赖：

```json5
{
  "dependencies": {
    // 播放器 SDK 对外接口依赖
    "@polyvharmony/media-player-sdk": "version",
    // 播放器内核依赖
    "@polyvharmony/media-player-core-ijk": "version"
  }
}
```

播放器 SDK 的播放内核、日志打印、数据存储等组件均需要在播放视频前完成配置，您可以参考 demo 项目中的`PLVMediaPlayerStartUp`类，完成播放器 SDK 的初始化配置。

```ts
// 配置全局 AppContext
PLVMediaPlayerAppContext.getInstance().setupAppContext(context)
// 配置日志
PLVMediaPlayerLogger.loggerImpl = new HiLogImpl()
// 配置数据存储
PLVKVStore.setupImplement(new PLVKVStoreOhosImpl(context))
// 配置播放内核
PLVMediaPlayerFactory.getInstance().register(PLVMediaPlayerCoreIjkProvider.getInstance())
```

**3.5 跳转播放页面**

demo 模块提供了 3 个页面，分别是：

1. `PLVMediaPlayerEntrancePage`是项目演示的入口页面，演示了如何跳转到长视频播放页面
2. `PLVMediaPlayerSingleVideoPage`是长视频播放页面，支持单视频的横竖屏播放方式
3. `PLVMediaPlayerFeedVideoPage`是短视频播放页面，支持上下滑动切换的沉浸式观看方式

您可以根据项目实际需要，在您项目的任意页面跳转到播放页面。

**3.6 参数修改**

为了在 demo 项目播放您账号下的视频，您需要对项目默认配置的参数进行修改。

demo 项目中，默认配置的视频数据在 mock 文件夹下的`PLVMockMediaResourceData`类当中，您可以对其中的参数进行修改：

* mockAuthentication：配置账号信息
* mockViewerParam：配置观看用户信息
* setupMediaResources()：配置视频数据源
