すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo VOD:SDK の統合

最終更新日:Aug 14, 2026

ApsaraVideo Player SDK for iOS をプロジェクトに迅速に統合します。

要件

  • オペレーティングシステム:iOS 8.0 以降。

  • 開発ツール:Xcode を推奨します。本ドキュメントでは Xcode を使用します。ダウンロード先: ‎Xcode

  • ApsaraVideo Player SDK for iOS はシミュレータをサポートしていません。アプリケーションは実機で実行する必要があります。

前提条件

  • プレーヤーの権限付与用のライセンスファイル (AliVideoCert-********.crt など) を取得済みであること。詳細については、「ライセンスの取得」をご参照ください。

  • 手動統合の場合は、最新の ApsaraVideo Player SDK for iOS パッケージをダウンロード済みであること。「ダウンロード」をご参照ください。

注意事項

  • アプリケーションをパッケージ化する際、dSYM ファイルはクラッシュレポートのシンボル化に使用されます。

  • ApsaraVideo Player SDK for iOS には、AlivcFFmpeg フレームワークと AliyunPlayer フレームワークが必要です。プレーヤーのヘッダーファイルは AliyunPlayer に含まれています。

  • プレーヤー SDK とショートビデオ SDK の両方を統合する場合は、ショートビデオ SDK、プレーヤー SDK、AlivcFFmpeg 間のバージョン互換性を確保してください。バージョンが一致しない場合、機能が正常に動作しない可能性があります。詳細については、「AlivcFFmpeg の依存関係」をご参照ください。

  • ApsaraVideo Player SDK for iOS パッケージには、シミュレータ用のアーキテクチャが含まれています。App Store への申請前に、これらを削除してください。削除しない場合、申請が却下される可能性があります。

ステップ 1: SDK の統合

CocoaPods による統合

  1. CocoaPods をインストールします。Ruby 環境が必要です。

    // ターミナルで次のコマンドを実行します:
    sudo gem install cocoapods
  2. CocoaPods のインストールを確認します。

    ターミナルで pod --version を実行して、インストールを確認します。

    xxx@ ~ % pod --version
    1.16.2
  3. Podfile を作成します。

    ターミナルでプロジェクトディレクトリに移動し、pod init を実行して Podfile を作成します。

    // プロジェクトディレクトリに移動します。
    xxx@ ~ %  cd /path/yourProject
    // Podfile を生成します。
    xxx@ yourProject % pod init
  4. Podfile を編集して、プレーヤー SDK の依存関係を追加します。

    説明
    • プレーヤー SDK とショートビデオ SDK の両方を統合する場合は、以下のコード内の AliPlayerSDK_iOSAliPlayerPartSDK_iOS に置き換えてください。AliPlayerPartSDK_iOS には FFmpeg が含まれていないため、ショートビデオ SDK の FFmpeg との競合を回避できます。

    • プレーヤー SDK の正しいバージョン番号を入力してください。正しくない場合、インポートが失敗してエラーが発生します。プレーヤー SDK のバージョンについては、「ApsaraVideo Player SDK for iOS リリースノート」をご参照ください。

    source 'https://github.com/CocoaPods/Specs.git'
    platform:ios, '8.0'
    
    target 'yourProject' do
        # プレーヤー SDK。最新バージョンの使用を推奨します。
        pod 'AliPlayerSDK_iOS'
    end
  5. (オプション) 特定バージョンのプレーヤー SDK への依存関係を追加します。

    source 'https://github.com/CocoaPods/Specs.git'
    platform:ios, '8.0'
    
    player_sdk_version = '7.17.0'
    
    target 'yourProject' do
        # プレーヤー SDK。最新バージョンの使用を推奨します。
        pod 'AliPlayerSDK_iOS' , player_sdk_version
    end
  6. 依存関係をインストールします。

    次のコマンドを実行して、依存関係をインストールします。

    pod install

    次の出力が表示されたら、インストールは成功です。

    xxx@ yourProject % pod install
    Analyzing dependencies
    Downloading dependencies
    Installing AliPlayerSDK_iOS (7.17.0)
    Generating Pods project
    Integrating client project
    Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

    プレーヤー SDK を更新するには、次のコマンドを実行します。

    pod update AliPlayerSDK_iOS

手動統合

説明

プレーヤー SDK とショートビデオ SDK の両方を統合する場合は、AlivcFFmpeg フレームワークを 1 つだけインポートし、正しいバージョンを使用していることを確認してください。

  1. ApsaraVideo Player SDK for iOS をダウンロードします。

  2. プレーヤーのフレームワークを [Frameworks, Libraries, and Embedded Content] に追加し、[Embed][埋め込みと署名] に設定します。

    • alivcffmpeg.framework:プレーヤーの基盤となるフレームワーク。

    • AliyunMediaDownloader.framework:オフラインダウンロードに使用します。

    • AliyunPlayer.framework:プレーヤーのフレームワーク。

      本地集成

  3. [Build Settings] タブをクリックします。

  4. [Search Paths] セクションで、[Framework Search Paths] をローカルのフレームワークディレクトリに設定します。

(オプション) RTS の統合 (CocoaPods)

リアルタイムストリーミング (RTS) コンポーネントを統合する場合は、「iOS での RTS ベースのストリームプルの実装」をご参照ください。

ステップ 2: ライセンスの構成

重要

中国本土、香港、マカオ以外の地域 (国際サイト) でプレーヤーを使用する場合は、他のプレーヤー API を呼び出す前に、次の API を呼び出して環境を設定する必要があります。

  1. 方法 1:次の API を呼び出して、デフォルト構成を国際サイト環境に更新します。

    // 国際サイトの場合、他のプレーヤー API を呼び出す前に、この API を呼び出して
    // 環境を設定する必要があります。この設定は実行時に変更できません。
    AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;
  2. 方法 2(推奨):プレーヤー SDK バージョン 7.6.0 以降では、Info.plist ファイルで国際サイト環境を構成できます。

    Info.plist ファイルを開き、AlivcEnv の値を SEA に変更します。

    // 現在の環境を国際サイトとして構成します。
    <key>AlivcEnv</key>
    <string>SEA</string>

    次の図に構成例を示します: 1754557498401-1d235342-3c0b-4c83-bcee-ae7656e8ff23

iOS クライアントでライセンスを構成する方法については、「iOS でのライセンスの構成」をご参照ください。

ステップ 3: ログの有効化 (オプション)

問題のトラブルシューティングに役立てるため、ログを有効にします。ログの取得方法については、「SDK ログの取得」をご参照ください。

// ログを有効にします。
[AliPlayer setEnableLog:YES];
// ログレベルを設定します。デフォルトは LOG_LEVEL_INFO です。トラブルシューティングの場合は、LOG_LEVEL_TRACE に設定してください。
[AliPlayer setLogCallbackInfo:LOG_LEVEL_INFO callbackBlock:nil];

プロジェクト構造

フレームワーク

説明

alivcffmpeg.framework

プレーヤーの基盤となるフレームワーク。必須です。

AliyunMediaDownloader.framework

オフラインダウンロードに使用します。オプションです。

AliyunPlayer.framework

プレーヤーのフレームワーク。必須です。

artcSource.framework

ARTC プロトコルをサポートします。オプションです。

説明

ARTC プロトコルをサポートするには、RtsSDK.framework も追加する必要があります。統合の詳細については、「iOS での RTS ベースのストリームプルの実装」をご参照ください。

aemFilter.framework

オーディオエンハンスメントを有効にします。オプションです。

libPluginSR.framework

超解像を有効にします。オプションです。

normalsrFilter.framework

超解像を有効にします。オプションです。

srFilter.framework

超解像を有効にします。オプションです。

vfiFilter.framework

ビデオフレーム挿入を有効にします。オプションです。

vvcCodecPlugin.framework

H.266 デコードプラグイン。オプションです。

よくある質問

CocoaPods の使用

// プロジェクトを CocoaPods の依存関係から分離します。
pod deintegrate 

// ローカルの CocoaPods ソースリポジトリのインデックスを更新します。
// 使用例:
// - 新しい依存関係を追加する場合、これにより最新の利用可能なバージョンを取得できます。
// - 特定のライブラリバージョンが利用できない、または新しいバージョンが存在するにもかかわらずプロジェクトに表示されない場合は、このコマンドで更新します。
pod repo update

// プロジェクトの Pods を更新します。
// 使用例:
// - プロジェクト内のすべての Pods を、Podfile で許可されている最新のサポートバージョンに更新する場合に使用します。
pod update

// 'pod install' と同じ機能を実行しますが、インストール前にローカルの CocoaPods リポジトリインデックスを強制的に更新します。
// 使用例:
// - このコマンドは、新しいライブラリを追加する場合や、Podfile で指定したライブラリの最新バージョンを使用したい場合に推奨されます。特に、必要なライブラリのバージョンが利用できないというエラーメッセージが表示された場合に有効です。
pod install --repo-update

// Pods のキャッシュをクリアします。
// 注:
// 1. キャッシュをクリアしても、Podfile.lock や Podfile は変更されません。'pod install' または 'pod update' を実行すると、CocoaPods は Podfile と Podfile.lock に基づいて必要なライブラリを再ダウンロードします。
// 2. キャッシュのクリアは通常の手順ではなく、特定の問題を解決する場合にのみ使用してください。通常、CocoaPods はキャッシュを適切に管理します。
pod cache clean --all

AlivcFFmpeg とのシンボル競合

解決策:

  • AlivcFFmpeg とのシンボル競合が発生した場合は、冗長な依存関係を削除してください。ApsaraVideo Player SDK for iOS に付属するバージョンを残し、サードパーティ製のものは削除してください。この操作により、サードパーティ製プレーヤーの機能に影響が出る可能性があります。

サンドボックスエラー

  • 問題:

    截屏2024-12-06 16

  • 解決策:

    UserSetting で、User Script SandBoxing を NO に設定します。

    1735888658101-5633103e-468d-4341-adaa-f5f52814aa36

ショートビデオ SDK の統合

ApsaraVideo Player SDK for iOS とショートビデオ SDK の両方を統合する場合は、iOS 用オールインワン SDK を使用して、クラスの重複やコンパイルの失敗を回避してください。

その他のプレーヤーに関する問題と解決策については、「ApsaraVideo Player に関するよくある質問」をご参照ください。

関連ドキュメント

基本機能

高度な機能