ApsaraVideo Player SDK for iOS をプロジェクトに迅速に統合します。
要件
-
オペレーティングシステム:iOS 8.0 以降。
-
開発ツール:Xcode を推奨します。本ドキュメントでは Xcode を使用します。ダウンロード先: Xcode。
-
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 による統合
-
CocoaPods をインストールします。Ruby 環境が必要です。
// ターミナルで次のコマンドを実行します: sudo gem install cocoapods -
CocoaPods のインストールを確認します。
ターミナルで
pod --versionを実行して、インストールを確認します。xxx@ ~ % pod --version 1.16.2 -
Podfile を作成します。
ターミナルでプロジェクトディレクトリに移動し、
pod initを実行して Podfile を作成します。// プロジェクトディレクトリに移動します。 xxx@ ~ % cd /path/yourProject // Podfile を生成します。 xxx@ yourProject % pod init -
Podfile を編集して、プレーヤー SDK の依存関係を追加します。
説明-
プレーヤー SDK とショートビデオ SDK の両方を統合する場合は、以下のコード内の
AliPlayerSDK_iOSをAliPlayerPartSDK_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 -
-
(オプション) 特定バージョンのプレーヤー 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 -
依存関係をインストールします。
次のコマンドを実行して、依存関係をインストールします。
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 つだけインポートし、正しいバージョンを使用していることを確認してください。
-
ApsaraVideo Player SDK for iOS をダウンロードします。
-
プレーヤーのフレームワークを [Frameworks, Libraries, and Embedded Content] に追加し、[Embed] を [埋め込みと署名] に設定します。
-
alivcffmpeg.framework:プレーヤーの基盤となるフレームワーク。
-
AliyunMediaDownloader.framework:オフラインダウンロードに使用します。
-
AliyunPlayer.framework:プレーヤーのフレームワーク。

-
-
[Build Settings] タブをクリックします。
-
[Search Paths] セクションで、[Framework Search Paths] をローカルのフレームワークディレクトリに設定します。
(オプション) RTS の統合 (CocoaPods)
リアルタイムストリーミング (RTS) コンポーネントを統合する場合は、「iOS での RTS ベースのストリームプルの実装」をご参照ください。
ステップ 2: ライセンスの構成
中国本土、香港、マカオ以外の地域 (国際サイト) でプレーヤーを使用する場合は、他のプレーヤー API を呼び出す前に、次の API を呼び出して環境を設定する必要があります。
-
方法 1:次の API を呼び出して、デフォルト構成を国際サイト環境に更新します。
// 国際サイトの場合、他のプレーヤー API を呼び出す前に、この API を呼び出して // 環境を設定する必要があります。この設定は実行時に変更できません。 AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA; -
方法 2(推奨):プレーヤー SDK バージョン 7.6.0 以降では、
Info.plistファイルで国際サイト環境を構成できます。Info.plistファイルを開き、AlivcEnvの値をSEAに変更します。// 現在の環境を国際サイトとして構成します。 <key>AlivcEnv</key> <string>SEA</string>次の図に構成例を示します:

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 の使用
AlivcFFmpeg とのシンボル競合
解決策:
-
AlivcFFmpeg とのシンボル競合が発生した場合は、冗長な依存関係を削除してください。ApsaraVideo Player SDK for iOS に付属するバージョンを残し、サードパーティ製のものは削除してください。この操作により、サードパーティ製プレーヤーの機能に影響が出る可能性があります。
サンドボックスエラー
-
問題:

-
解決策:
UserSetting で、User Script SandBoxing を NO に設定します。

ショートビデオ SDK の統合
ApsaraVideo Player SDK for iOS とショートビデオ SDK の両方を統合する場合は、iOS 用オールインワン SDK を使用して、クラスの重複やコンパイルの失敗を回避してください。
その他のプレーヤーに関する問題と解決策については、「ApsaraVideo Player に関するよくある質問」をご参照ください。