ApsaraVideo VOD：整合準備

開發環境配置

在使用AliPlayerKit之前，請確保您的開發環境滿足以下要求：

• JDK 11

  • 配置方式：Preferences → Build, Execution, Deployment → Build Tools → Gradle → Gradle JDK。

  • 選擇11（如果沒有11，請升級Android Studio版本）。

• Android開發環境

  • 安裝最新版本的Android Studio。

  • 配置Android SDK，最低支援API層級為21（Android 5.0）。

  • compileSdkVersion建議使用31或以上。

  • Gradle版本不低於7.0。

License準備

已擷取音視頻終端SDK的播放器License授權認證和License Key，詳情請參見管理License。

步驟1：拷貝組件模組

將playerkit核心模組（library）目錄拷貝到您的專案中：

# 將playerkit核心模組拷貝到您的專案根目錄下
# 注意：僅拷貝playerkit目錄，而非整個專案或playerkit-examples、playerkit-scenes等樣本模組
cp -r playerkit /path/to/your/project/

步驟2：Gradle專案配置

repositories {
    // aliyun maven
    maven { url "https://maven.aliyun.com/repository/releases" }
}

repositories {
    // aliyun maven
    maven("https://maven.aliyun.com/repository/releases")
}

include ':playerkit'

include(":playerkit")

dependencies {
    // AliPlayerKit核心模組：提供開箱即用、可配置的播放器UI組件，覆蓋基礎播放與常見互動能力
    implementation project(':playerkit')
}

dependencies {
    // AliPlayerKit核心模組：提供開箱即用、可配置的播放器UI組件，覆蓋基礎播放與常見互動能力
    implementation(project(":playerkit"))
}

步驟3：配置License

<meta-data
    android:name="com.aliyun.alivc_license.licensekey"
    android:value="您的License Key" />
<meta-data
    android:name="com.aliyun.alivc_license.licensefile"
    android:value="assets/cert/license.crt" />          

步驟4：驗證整合

./gradlew clean assemble --stacktrace --info

git add .
git commit -m "feat: integrate AliPlayerKit module (source commit: 2c30d92)"            

步驟1：拷貝情境模組

根據業務需求，拷貝所需的情境模組到您的專案中：

# scene-common包含樣本視頻常量，如自行實現視頻源可省略
cp -r playerkit-scenes/scene-common /path/to/your/project/

# 其他情境模組按需選擇
cp -r playerkit-scenes/scene-longvideo /path/to/your/project/
cp -r playerkit-scenes/scene-live /path/to/your/project/
# ...         

步驟2（可選）：處理模組依賴

情境模組的build.gradle中依賴了demo-settings和scene-common，整合時需根據實際情況調整：

dependencies {
    // ...
    // 刪除此行：demo-settings僅用於Demo示範
    // implementation project(':demo-settings')
}          

dependencies {
    // ...
    // 如自行實現視頻源，可注釋或刪除此行
    // implementation project(':scene-common')
}          

// ===== 原代碼（使用demo-settings / scene-common）=====
import com.aliyun.playerkit.example.settings.link.LinkConstants;
import com.aliyun.playerkit.example.settings.storage.SPManager;
import com.aliyun.playerkit.scenes.common.SceneConstants;

private String getVideoVid() {
    String savedVid = SPManager.getInstance().getString(LinkConstants.KEY_VIDEO_VID);
    return StringUtil.isNotEmpty(savedVid) ? savedVid : SceneConstants.LANDSCAPE_SAMPLE_VID;
}

// ===== 替換後（使用您的視頻源）=====
private String getVideoVid() {
    return "您的視頻Vid";  // 或從您的業務介面擷取
}

private String getVideoPlayAuth() {
    return "您的PlayAuth";  // 或從您的業務介面擷取
}           

步驟3：Gradle專案配置

include ':scene-common'
include ':scene-longvideo'
// 按需添加其他情境模組...

include(":scene-common")
include(":scene-longvideo")
// 按需添加其他情境模組...

dependencies {
    // AliPlayerKit播放情境模組：基於AliPlayerKit核心組件，提供開箱即用的標準播放情境方案
    // 中長視頻情境模組：提供中長視頻播放的完整解決方案
    implementation project(':scene-longvideo')
}

dependencies {
    // AliPlayerKit播放情境模組：基於AliPlayerKit核心組件，提供開箱即用的標準播放情境方案
    // 中長視頻情境模組：提供中長視頻播放的完整解決方案
    implementation(project(":scene-longvideo"))
}

步驟4：驗證整合

同步Gradle並編譯專案，確認依賴與模組配置正確：

./gradlew clean assemble --stacktrace --info       

查看版本資訊

當前AliPlayerKit依賴的SDK版本資訊定義在playerkit/build.gradle檔案中。

您可以通過以下連結查看相關SDK的最新版本及文檔：

• 下載播放器SDK。

• Android SDK發布歷史。

• Android端實現RTS拉流。

升級步驟

1. 確認版本相容性

   升級前建議查閱SDK發布歷史與更新日誌，確認目標版本是否存在Breaking Changes或其他相容性調整。

2. 修改版本號碼

   在playerkit/build.gradle中修改SDK版本號碼：

   def player_sdk_version = "x.x.x"  // 替換為目標版本
   api "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
   
   // AlivcArtc 橋接層版本號碼需與播放器版本保持一致
   api "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version"
   
   // RtsSDK 版本號碼需與播放器版本保持一致
   def rts_sdk_version = "x.x.x"  // 替換為目標版本
   api "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"         

3. 驗證升級：

   • 清理並重新編譯專案：

     ./gradlew clean assemble --stacktrace --info                

   • 驗證核心播放功能：播放、暫停、Seek、倍速等。

   • 驗證特定播放情境：如RTS超低延時直播等。

License相關問題

問題：播放器出現License錯誤。

解決方案：

1. 確認已正確配置License認證和Key。

2. 檢查License是否已到期。

3. 確認包名與License綁定的包名一致。

4. 如未配置正確的License，整合完畢後會出現播放黑屏等異常問題。

依賴衝突問題

問題：Gradle同步失敗，提示依賴衝突。

解決方案：

1. 檢查專案中是否已存在相同依賴的不同版本。

2. 使用exclude排除衝突依賴。

3. 統一專案中的依賴版本。

4. 如果您的專案中已有相同第三方庫，請調整playerkit模組中的版本號碼，以確保相容性並避免衝突。

初始化失敗問題

問題：調用AliPlayerKit.init()拋出異常。

解決方案：

1. 確認Context不為null。

2. 確認在Application.onCreate()中調用。

3. 檢查是否重複調用（重複調用會被忽略，不會拋異常）。

SDK版本配置問題

問題：編譯時間報SDK版本不匹配錯誤。

解決方案：

請確保playerkit模組的配置（如compileSdkVersion、buildToolsVersion、minSdkVersion、targetSdkVersion等）與您的專案中的設定保持一致。

Namespace相關問題

問題：直接拷貝模組後，編譯時間出現Namespace相關的錯誤。

解決方案：

各模組的build.gradle中已預設聲明了namespace，適配AGP 7.x及以上版本。根據您專案的AGP版本進行以下調整：

配置位置：各模組build.gradle的android {}塊中

android {
    /// 整合FAQ (Integration FAQ)
    /// 關於namespace聲明的注意事項：
    /// - AGP版本 ≥ 8.0（如8.3.2）：必須聲明namespace
    /// - AGP版本 < 7.0（如4.0.1）：需移除namespace聲明，使用AndroidManifest.xml的package屬性
    /// - AGP版本7.x：namespace聲明可選，建議聲明以相容未來升級
    namespace = "com.aliyun.playerkit"
    // ...
}  

模擬器不支援問題

問題：在模擬器上運行出現異常。

解決方案：

Android播放器SDK不支援模擬器，整合完成後需在真機上測試。

Repository優先順序衝突

問題：Gradle在處理repository的優先順序時出現衝突。

解決方案：

請優先在settings.gradle中添加repository。