ApsaraVideo VOD：整合準備

開發環境要求

License準備

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

步驟1：拷貝模組到專案中

將PlayerKit/目錄拷貝到您的專案工程目錄下（與您的Podfile同級或合適的子目錄中）：

YourProject/
├── YourApp/
├── PlayerKit/                  # ← 拷貝此目錄
│   ├── PlayerKit.podspec
│   ├── Source/
│   └── Resources/
└── Podfile

步驟2：配置Podfile

在Podfile中通過本地路徑引用PlayerKit：

platform :ios, '9.0'

target 'YourApp' do
  use_frameworks!

  # 核心組件（必選，通過本地路徑引用）
  pod 'PlayerKit', :path => './PlayerKit'

  # 底層播放器SDK（必選）
  pod 'AliPlayerSDK_iOS', '~> 7.15.0'

  # 直播RTS超低延時（可選，僅直播情境需要）
  # pod 'AliPlayerSDK_iOS_ARTC', '~> 7.15.0'
  # pod 'RtsSDK', '~> 7.12.0'
end

步驟3：安裝依賴

pod install
open YourApp.xcworkspace

步驟4：配置License

播放器SDK需要有效License授權才能正常工作。請參閱管理License完成License的擷取與配置。

步驟5：全域初始化

在AppDelegate中完成架構初始化（整個應用生命週期只需調用一次）：

#import <PlayerKit/AliPlayerKit.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // （可選）全域 SDK 配置，如 setOption 等
    // [AliPlayerKit setOnGlobalInitBlock:^{
    //     // 全域配置在 setup 後僅執行一次
    // }];

    // 初始化 AliPlayerKit
    [AliPlayerKit setup];

    return YES;
}

import AliPlayerKit

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // （可選）全域 SDK 配置
    // AliPlayerKit.setOnGlobalInitBlock {
    //     // 全域配置在 setup 後僅執行一次
    // }

    // 初始化 AliPlayerKit
    AliPlayerKit.setup()

    return true
}

步驟6：驗證整合

驗證檢查清單：

• pod install成功，無依賴衝突。

• License已正確配置。

• AppDelegate中調用[AliPlayerKit setup]。

• 編譯通過（Cmd + B），無連結錯誤。

步驟1：拷貝模組到專案中

將PlayerKitScenes/目錄拷貝到專案中（與PlayerKit/同級）：

YourProject/
├── YourApp/
├── PlayerKit/                  # 組件層（已拷貝）
├── PlayerKitScenes/            # ← 拷貝此目錄
│   ├── PlayerKitScenes.podspec
│   ├── SceneCommon/
│   ├── SceneLongVideo/
│   ├── SceneShortVideo/
│   ├── SceneLive/
│   └── ScenePlaylist/
└── Podfile

步驟2：配置Podfile

在 Podfile 中通過本地路徑引用 PlayerKitScenes：

target 'YourApp' do
  use_frameworks!

  # 核心組件（必選）
  pod 'PlayerKit', :path => './PlayerKit'
  pod 'AliPlayerSDK_iOS', '~> 7.15.0'

  # 播放情境方案（按需引入）
  pod 'PlayerKitScenes', :path => './PlayerKitScenes'

  # 或按需選擇單個情境：
  # pod 'PlayerKitScenes/SceneLongVideo', :path => './PlayerKitScenes'
  # pod 'PlayerKitScenes/SceneShortVideo', :path => './PlayerKitScenes'
  # pod 'PlayerKitScenes/SceneLive', :path => './PlayerKitScenes'
  # pod 'PlayerKitScenes/ScenePlaylist', :path => './PlayerKitScenes'
end

情境模組說明：

步驟3：安裝並驗證

pod install

編譯通過即表示情境層整合成功。

查看版本資訊

• 運行時可通過 [AliPlayerKit getSdkVersion] 擷取底層 SDK 版本號碼。

• 通過 [AliPlayerKit getPlayerKitVersion] 擷取 AliPlayerKit 組件版本號碼。

• 查看下載播放器SDK和iOS SDK發布歷史。

升級步驟

1. 確認版本相容性。

   升級前建議查閱 SDK 發布歷史與更新日誌，確認目標版本是否存在 Breaking Changes。

2. 修改 Podfile 版本號碼。

   pod 'AliPlayerSDK_iOS', '~> x.x.x'  # 替換為目標版本
   
   # RTS（如使用直播情境）
   # pod 'AliPlayerSDK_iOS_ARTC', '~> x.x.x'
   # pod 'RtsSDK', '~> x.x.x'

3. 執行更新。

   pod update AliPlayerSDK_iOS

4. 驗證升級。

   • 編譯通過，無連結錯誤。

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

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

License相關問題

問題：播放器報License錯誤或播放黑屏。

請確認License已正確擷取與配置，詳見管理License。常見原因包括：認證檔案未正確添加到工程、License Key不匹配、Bundle ID與License綁定的包名不一致、License已到期等。

依賴衝突問題

問題：pod install失敗，提示依賴衝突。

排查步驟：檢查專案中是否已存在SDWebImage的不同版本（PlayerKit依賴SDWebImage）；使用pod update嘗試更新到相容版本；執行pod repo update重新整理本地倉庫索引後重試。

初始化問題

問題：調用 [AliPlayerKit setup] 後播放異常。

排查步驟：

1. 確認在 AppDelegate 的 application:didFinishLaunchingWithOptions: 中調用。

2. 確認 License 已正確配置（詳見 管理License）。

3. 通過 [AliPlayerKit isInitialized] 確認初始化成功。

4. setup 內建等冪保護（dispatch_once），重複調用不會拋異常。

5. 如需注入全域 SDK 配置，確認 setOnGlobalInitBlock: 在 setup 之前設定。

日誌調試

如果遇到播放異常，可開啟調試日誌輔助排查：

// 開啟偵錯模式
[AliPlayerKit setDebugModeEnabled:YES];
// 設定記錄層級為 Verbose，輸出最詳細的日誌
[AliPlayerKit setLogLevel:LogLevelVerbose];

日誌系統的詳細使用方式請參閱 日誌系統。