iOS 向けショートビデオ SDK の統合 - ApsaraVideo VOD - Alibaba Cloud ドキュメントセンター

このトピックでは、Pod を使用して iOS 向けショートビデオ SDK を統合する方法について説明します。

前提条件

開発環境が次の要件を満たしていることを確認してください。

項目	説明
OS バージョン	iOS 9.0 以降。
macOS High Sierra バージョン	macOS High Sierra 10.13 以降。
Xcode バージョン	Xcode 9.0 以降。Xcode のダウンロード。

背景情報

ショートビデオ SDK は、Professional Edition、Standard Edition、Basic Edition があります。3 つのエディションはすべて AliVCSDK_ShortVideo.framework ライブラリを使用します。ビジネスニーズに合ったエディションのライセンスを取得する必要があります。

Basic Edition には、録画モジュールとクロップモジュールのみが含まれています。
Professional Edition と Standard Edition はフル機能です。Standard Edition の高度な API オペレーションを呼び出すには、別途権限付与を取得する必要があります。

説明

ショートビデオ SDK のアップデートについては、「リリースノート」をご参照ください。

統合

ショートビデオ SDK と Player SDK の両方を使用する必要がある場合は、ApsaraVideo MediaBox SDK を統合することを推奨します。このオールインワンソリューションは、複数の SDK を個別に統合することで発生する可能性のある依存関係の競合を防ぎます。統合手順については、「ApsaraVideo MediaBox SDK for iOS」をご参照ください。
ショートビデオ SDK と Player SDK を個別に統合する場合は、ショートビデオ SDK、Player SDK、および AlivcFFmpeg の互換性のあるバージョンを使用する必要があります。そうしないと、これらの SDK の機能が正しく動作しない可能性があります。詳細については、「AlivcFFmpeg のバージョン依存関係」をご参照ください。

Pod 統合

SDK のバージョンに基づいて、Podfile に依存関係を追加します。
重要
- ショートビデオ SDK 3.24.0 以降を使用する場合、FFmpeg 4.3.0 以降を使用する必要があります。
- ネットワークが Pod リポジトリへのアクセスと更新を許可していることを確認してください。pod install コマンドを実行した後、フレームワークのバージョンが公式サイトの最新バージョンと一致することを確認します。
- 最小限の依存関係でショートビデオ SDK を統合し、メディアファイルを ApsaraVideo VOD にアップロードする必要がある場合は、Upload SDK も統合する必要があります。詳細については、「Upload SDK」をご参照ください。
- V7.0.0 以降の場合
```
pod 'AliVCSDK_ShortVideo', '~> 7.11.0'
```
- V6.21.0 以前の場合
```
pod 'AliyunVideoSDKBasic', '~> 6.21.0' // Basic Edition に必要
pod 'AliyunVideoSDKStd', '~> 6.21.0'	// Standard Edition に必要
pod 'AliyunVideoSDKPro', '~> 6.21.0'	// Professional Edition に必要
```
Pod リポジトリを更新します。
```
pod repo update
```
Pod をインストールします。
```
pod install
```

プロジェクト設定

SDK を統合した後、Xcode でプロジェクトを開き、次の設定を構成します。

[Build Setting] > [Linking] > [Other Linker Flags] で、-ObjC フラグを追加します。

プロジェクトの Info.plist ファイルに、次の権限を追加します。

Privacy - Camera Usage Description
Privacy - Microphone Usage Description
Privacy - Photo Library Usage Description

ライセンス設定

ライセンスを取得した後、次の手順に従ってライセンスファイルを設定します。ライセンスの取得方法については、「ショートビデオ SDK のライセンス取得」をご参照ください。

ダウンロードしたライセンスファイルをアプリケーションプロジェクトにインポートします。次に、Info.plist ファイルに 2 つのキーと値のペアを追加します。最初のキーには AlivcLicenseKey を入力し、その値にライセンスキーを設定します。2 番目のキーには AlivcLicenseFile を入力し、その値にメインバンドルからの埋め込みライセンスファイルの相対パスを設定します。例：

キー	値
AlivcLicenseKey	ご利用のライセンスキー。例： MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****
AlivcLicenseFile	メインバンドルからの埋め込みライセンスファイルの相対パス。

次のステップ

SDK の初期化

Player の統合

プロジェクトに iOS 向けショートビデオ SDK と Player SDK の両方を統合する必要がある場合は、ApsaraVideo MediaBox SDK for iOS を使用することを推奨します。これにより、クラスの重複によるコンパイルエラーを防ぐことができます。

ApsaraVideo VOD:SDK の統合