ApsaraVideo VOD:統合の準備

開発環境

ライセンス

ApsaraVideo Player SDK のプレーヤー用ライセンス証明書と License Key が必要です。詳細については、「Manage License」をご参照ください。

手順 1：モジュールのプロジェクトへのコピー

PlayerKit/ ディレクトリを、プロジェクトのディレクトリ (Podfile と同じ階層、または適切なサブディレクトリ) にコピーします:

YourProject/
├── YourApp/
├── PlayerKit/                  # ← このディレクトリをコピー
│   ├── PlayerKit.podspec
│   ├── Source/
│   └── Resources/
└── Podfile

手順 2：Podfile の設定

Podfile で、ローカルパスを使用して PlayerKit を参照します：

platform :ios, '11.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：ライセンスの設定

プレーヤー SDK が動作するには、有効なライセンスが必要です。ライセンスの取得と設定については、「Manage License」をご参照ください。

手順 5：グローバル初期化

このメソッドは、アプリケーションのライフサイクル中に 1 回だけ呼び出してください：

#import <AliPlayerKit/AliPlayerKit.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // (オプション) setOption などのグローバル SDK 設定
    // [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 は依存関係の競合なしで正常に完了します。

• ライセンスが正しく設定されていること。

• [AliPlayerKit setup] は AppDelegate で呼び出されます。

• プロジェクトがリンカエラーなしで正常にビルドできること (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 コンポーネントのバージョン番号を取得するには、 [AliPlayerKit getPlayerKitVersion] を呼び出します。

• 「Download Player SDK」および「iOS SDK Release History」をご参照ください。

アップグレード手順

1. バージョン互換性を確認します。

   アップグレード前に、SDK のリリース履歴と変更履歴を確認し、対象バージョンに破壊的変更が含まれているかどうかを確認してください。

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. アップグレードを検証します。

   • プロジェクトがリンカエラーなしで正常にビルドできること。

   • コア再生機能 (再生、一時停止、シーク、再生速度など) を確認します。

   • RTS を使用した超低遅延ライブストリーミングなど、特定の再生シナリオを確認します。

ライセンスに関する問題

問題：プレーヤーがライセンスエラーを報告する、またはブラックスクリーンが表示されます。

一般的な原因として、証明書ファイルの追加ミス、License Key の不一致、ライセンスに紐付けられた Bundle ID との不一致、またはライセンスの期限切れが挙げられます。詳細については、「Manage License」をご参照ください。

依存関係の競合

問題: pod installが依存関係の競合で失敗します。

トラブルシューティングの手順: この競合は、お使いのプロジェクトと PlayerKit が、異なるバージョンの SDWebImage に依存している場合に発生する可能性があります。競合を解決するには、pod update を実行してみてください。問題が解決しない場合は、pod repo update を実行してローカルリポジトリのインデックスを更新してから、再度お試しください。

初期化に関する問題

問題：[AliPlayerKit setup] を呼び出した後、再生が正常に動作しません。

トラブルシューティング手順：

1. AppDelegate内の application:didFinishLaunchingWithOptions:で呼び出しが行われるようにしてください。

2. ライセンスが正しく設定されていることを確認してください。詳細については、「Manage License」をご参照ください。

3. [AliPlayerKit isInitialized] を呼び出して、初期化が成功したか確認します。

4. setup メソッドは (dispatch_once を使用するため) べき等です。繰り返し呼び出しても安全であり、例外はスローされません。

5. グローバル SDK 設定を注入する必要がある場合は、setOnGlobalInitBlock: が、setup が呼び出される前に設定されていることを確認してください。

ログによるデバッグ

再生に関する問題が発生した場合は、デバッグログを有効化してトラブルシューティングに役立てることができます：

// デバッグモードを有効化します
[AliPlayerKit setDebugModeEnabled:YES];
// ログ出力を最も詳細にするには、ログレベルをVerbose に設定します
[AliPlayerKit setLogLevel:LogLevelVerbose];

ログシステムの使用方法の詳細については、「Logging System」をご参照ください。