2-快速集成

更新时间：2025-08-29 11:30:56

1 账号准备
2 环境要求
3 集成多场景项目

1 账号准备

在集成多场景 SDK 项目之前，请先在Polyv 官网注册账号，并开通云直播服务。

Demo 中登录直播需要账号直播系统中的appId（应用ID），appSecret（应用密匙），userId（账号ID），channelId（频道号），登录回放再额外需要频道号对应回放列表里的vid（回放视频id）。您可以登录直播后台，在开发者信息中获取参数。

2 环境要求

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

3 集成多场景项目

3.1 导入直播观看模块

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

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

3.2 配置播放器 SDK

多场景 SDK 的视频播放功能依赖于播放器 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 PLVLoggerImpl()
// 配置数据存储
PLVKVStore.setupImplement(new PLVKVStoreOhosImpl(context))
// 配置播放内核
PLVMediaPlayerFactory.getInstance().register(PLVMediaPlayerCoreIjkProvider.getInstance())

3.3 初始化多场景 SDK

多场景 SDK 需在模块 Ability 的 onWindowStageCreate 方法中进行初始化，您可以参考 demo 项目中的PLVEntryAbility类：

PLVLiveSceneSDK.init(context, windowStage)

3.4 跳转直播观看页面

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

PLVLoginPage是项目演示的登录页面，演示了如何跳转到直播观看页面
PLVLWWatchPage是直播观看页面，支持播放直播和回放视频，同时也支持聊天室、互动等功能

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

3.5 参数修改

为了在 demo 项目播放您账号下的视频，您需要对项目中登录所需的参数进行配置。

demo 项目中，登录参数在 pages 文件夹下的PLVLoginPage类中配置：

liveUserId/playbackUserId：账号Id
liveChannelId/playbackChannelId：频道Id
liveAppId/playbackAppId：应用Id
liveAppSecret/playbackAppSecret：应用密钥
playbackVid：回放视频Id
viewerId：学员(用户)Id
viewerName：学员(用户)昵称
viewerAvatar：学员(用户)头像地址

直播鸿蒙 SDK