2-快速集成

• 1 帳號準備
• 2 環境需求
• 3 整合多場景專案
  • 3.1 匯入直播觀看模組
  • 3.2 配置播放器 SDK
  • 3.3 初始化多場景 SDK
  • 3.4 跳轉直播觀看頁面
  • 3.5 參數修改

1 帳號準備

在整合多場景 SDK 專案之前，請先在 Polyv 官網 註冊帳號，並開通雲直播服務。

Demo 中登入直播需要帳號直播系統中的 appId（應用 ID）、appSecret（應用密鑰）、userId（帳號 ID）、channelId（頻道號），登入回放則額外需要頻道號對應回放列表中的 vid（回放影片 ID）。您可以登入直播後台，在 開發者資訊 中取得參數。

2 環境需求

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 個頁面，分別是：

1. PLVLoginPage 是專案示範的登入頁面，示範如何跳轉到直播觀看頁面
2. PLVLWWatchPage 是直播觀看頁面，支援播放直播和回放影片，同時也支援聊天室、互動等功能

您可以根據專案實際需求，在您專案的任意頁面跳轉到直播觀看頁面。

3.5 參數修改

為了在 demo 專案播放您帳號下的影片，您需要對專案中登入所需的參數進行配置。

demo 專案中，登入參數在 pages 資料夾下的 PLVLoginPage 類別中配置：

• liveUserId/playbackUserId：帳號 ID
• liveChannelId/playbackChannelId：頻道 ID
• liveAppId/playbackAppId：應用 ID
• liveAppSecret/playbackAppSecret：應用密鑰
• playbackVid：回放影片 ID
• viewerId：學員（使用者）ID
• viewerName：學員（使用者）暱稱
• viewerAvatar：學員（使用者）頭像網址