2-快速集成

1 帳號準備

在整合播放器 SDK 專案之前，請先在 Polyv 官網 註冊帳號，並開通雲端點播服務。

為了播放您帳號下的點播影片，播放器需要完成點播帳號鑑權。基礎接入可使用點播系統中的 userId 等帳號參數，您可以登入點播後台，在 API 介面 中取得。

基於安全考量，不建議將 secretKey 明文寫入客戶端程式碼或 APP 設定檔。正式環境更建議將 secretKey 保存在您的伺服器端，由伺服器端產生播放或下載所需的 token 後下發給客戶端。播放場景請參考 4-加密影片版權保護 中的「配置傳入 token」，下載場景請參考 5-影片下載 中的「自訂傳入 token」。

2 環境需求

3 整合播放器專案

3.1 導入通用模組（必須）

複製 demo 專案中的 common 模組到您專案的根目錄下，並修改專案的 settings.gradle 檔案，加入對 common 模組的引用：

include(":common")

3.2 導入長影片場景模組（選用）

複製 demo 專案中的 scenes-single-video 模組到您專案的根目錄下，並修改專案的 settings.gradle 檔案，加入對長影片場景模組的引用：

include(":scenes-single-video")

3.3 導入短影片場景模組（選用）

複製 demo 專案中的 scenes-feed-video 模組到您專案的根目錄下，並修改專案的 settings.gradle 檔案，加入對短影片場景模組的引用：

include(":scenes-feed-video")

3.4 整合場景佈局到頁面中

demo 模組中的 activity 資料夾提供了場景佈局的整合示範：

• PLVMediaPlayerSingleVideoActivity 類別示範如何整合長影片場景的佈局
• PLVMediaPlayerFeedVideoActivity 類別示範如何整合短影片場景的佈局

您可以參考這兩個類別的整合方式，將佈局整合到您業務頁面中

3.5 配置 Maven 倉庫

播放器 SDK 存放在私有的倉庫中，您需要在專案的 settings.gradle 檔案（舊版本的 Gradle 在 build.gradle 檔案）中加入 Maven 倉庫的配置：

repositories {
    maven {
        credentials {
            username = "609cc5623a10edbf36da9615"
            password = "EbkbzTNHRJ=P"
        }
        url = uri("https://packages.aliyun.com/maven/repository/2102846-release-8EVsoM/")
    }
}

3.6 Demo 參數修改

為了在 demo 專案中播放您帳號下的影片，您需要對專案預設配置的參數進行修改。

demo 專案中，預設配置的影片資料在 mock 資料夾下的 PLVMockMediaResourceData 類別中，您可以對其中的參數進行修改：

• mockAuthentication：配置帳號資訊
• mockViewerParam：配置觀看使用者資訊
• setup()：配置影片資料來源