2-快速集成
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()：設定影片資料來源
