2-快速集成

更新时间：2026-06-15 14:32:23

1 账号准备
2 环境要求
3 集成播放器项目

1 账号准备

在集成播放器 SDK 项目之前，请先在Polyv 官网注册账号，并开通云点播服务。

为了播放您账号下的点播视频，播放器需要完成点播账号鉴权。基础接入可使用点播系统中的userId等账号参数，您可以登录点播后台，在API 接口中获取。

出于安全考虑，不建议将secretKey明文写入客户端代码或 APP 配置文件。生产环境更建议将secretKey保存在您的服务端，由服务端生成播放或下载所需的 token 后下发给客户端。播放场景请参考4-加密视频版权保护中的“配置传入token”，下载场景请参考5-视频下载中的“自定义传入token”。

2 环境要求

名称	要求
compatibleSdkVersion	>= 5.0.0(12)
abiFilters	arm64-v8a, x86_64

3 集成播放器项目

3.1 导入通用模块

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

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

3.2 导入长视频场景模块

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

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

3.3 导入短视频场景模块

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

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

3.4 配置播放器 SDK

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

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

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

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

3.5 跳转播放页面

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

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

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

3.6 参数修改

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

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

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

鸿蒙播放器 SDK