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