このトピックでは、Pod を使用して iOS 用のショートビデオソフトウェア開発キット (SDK) を統合する方法について説明します。
前提条件
次の表に、環境要件を示します。
カテゴリ | 説明 |
OS バージョン | iOS 9.0 以降。 |
macOS High Sierra バージョン | macOS High Sierra 10.13 以降。 |
Xcode バージョン | Xcode 9.0 以降。 Xcode をダウンロードしてください。 |
背景情報
ショートビデオ SDK には、Professional、Standard、Basic の 3 つのエディションがあります。すべてのエディションで AliVCSDK_ShortVideo.framework ライブラリが使用されます。ビジネス要件に合ったライセンスを有効化する必要があります。
Basic Edition には、録画モジュールとトリミングモジュールのみが含まれます。
Professional Edition と Standard Edition には、すべての機能が含まれています。ただし、Standard Edition の高度な API 操作を呼び出すには、別途権限付与が必要です。
ショートビデオ SDK の機能更新については、「リリースノート」をご参照ください。
統合手順
ショートビデオ SDK とプレーヤー SDK の両方を使用するには、iOS 用の ApsaraVideo MediaBox を統合することを推奨します。このオールインワン SDK は、複数の SDK を個別に統合する際に発生する可能性のある依存関係の競合を防ぐのに役立ちます。統合の詳細については、「iOS」をご参照ください。
ショートビデオ SDK とプレーヤー SDK を個別に統合する場合は、ショートビデオ SDK、プレーヤー SDK、および AlivcFFmpeg 間のバージョン依存関係に注意する必要があります。そうしないと、ショートビデオ SDK またはプレーヤー SDK の機能が期待どおりに動作しない可能性があります。詳細については、「AlivcFFmpeg のバージョン依存関係」をご参照ください。
Pod を使用した統合
Podfile に依存関係を追加します。必要な依存関係は SDK のバージョンによって異なります。
重要ショートビデオ SDK V3.24.0 以降を使用する場合、FFmpeg 4.3.0 以降を使用する必要があります。
ご利用のネットワークが Pod リポジトリにアクセスできることを確認してください。`pod install` コマンドを実行した後、フレームワークのバージョンが公式サイトの最新バージョンと一致していることを確認してください。
最小限の依存関係でショートビデオ SDK を統合し、メディアアセットを ApsaraVideo VOD にアップロードする必要がある場合は、アップロード SDK も統合する必要があります。詳細については、「アップロード SDK」をご参照ください。
V7.0.0 以降の統合
pod 'AliVCSDK_ShortVideo', '~> 7.9.1'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 updatePod をインストールします。
pod install
プロジェクトの設定
SDK を統合した後、プロジェクトを開き、次の構成を変更します。
セクションに `-ObjC` を追加します。
プロジェクトの Info.plist ファイルを開き、次の権限を追加します。
Privacy - Camera Usage Description Privacy - Microphone Usage Description Privacy - Photo Library Usage Description
ライセンスの設定
ライセンスを取得した後、次のようにライセンスファイルを設定します。ライセンスの取得方法の詳細については、「ショートビデオ SDK のライセンス取得」をご参照ください。
ダウンロードしたライセンスファイルをアプリケーションプロジェクトにインポートします。Info.plist ファイルに 2 つのキーを追加します。最初のキーを AlivcLicenseKey に設定し、その値を LicenseKey に設定します。2 番目のキーを AlivcLicenseFile に設定し、その値を mainBundle に対する組み込み証明書ファイルの相対パスに設定します。次の表に例を示します。
キー | 値 |
AlivcLicenseKey | LicenseKey の値。例:MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1**** |
AlivcLicenseFile | mainBundle に対する組み込み証明書ファイルのパス。 |
次のステップ
Player の統合
iOS 用ショートビデオ SDK とプレーヤー SDK の両方をプロジェクトに統合する場合は、iOS 用オールインワン SDK の使用を推奨します。これにより、コンパイル失敗の原因となるクラスの重複問題を回避できます。