このトピックでは、iOS 向け ApsaraVideo MediaBox SDK を統合する方法について説明します。
使用方法に関する注意事項
ApsaraVideo MediaBox SDK V6.6.0 以前から V6.7.0 以後にアップデートする方法については、「ApsaraVideo MediaBox SDK V6.7.0 の統合されたレタッチ効果の更新」をご参照ください。
環境要件
項目 | 要件 |
macOS | macOS High Sierra 10.13 以降。 |
Xcode | Xcode をダウンロードするには、Mac App Store にアクセスしてください。 |
iOS | iOS 9.0 以降。 |
ステップ 1:SDK の統合
(推奨)CocoaPods を使用して SDK を統合する
プロジェクトディレクトリで
pod init
コマンドを実行して、Podfile を作成します。SDK の依存関係を Podfile に追加します。
次のコードの SDK バージョンは参照用です。 ApsaraVideo MediaBox SDK の最新バージョンの入手方法については、「SDK の選択とダウンロード」をご参照ください。
# ビジネスシナリオに基づいて、次の SDK のいずれかを統合します。 #1. オールインワン ApsaraVideo MediaBox SDK:再生、リアルタイムストリーミング(RTS)、標準ライブストリーミング、ショートビデオ制作、リアルタイムコミュニケーション(RTC)共同ストリーミング、および基本的なレタッチをサポートします。 pod 'AliVCSDK_Standard', '7.4.0' #2. 基本的なライブストリーミング用の ApsaraVideo MediaBox SDK:再生、ライブストリームの取り込み、基本的なレタッチ、および RTS をサポートします。 pod 'AliVCSDK_BasicLive', '7.4.0' #3. ショートビデオシナリオ用の ApsaraVideo MediaBox SDK:再生、ショートビデオ制作、および基本的なレタッチをサポートします。 pod 'AliVCSDK_UGC', '7.4.0' #4. インタラクティブストリーミング用の ApsaraVideo MediaBox SDK:再生、RTS、ライブストリームの取り込み、RTC 共同ストリーミング、および基本的なレタッチをサポートします。 pod 'AliVCSDK_InteractiveLive', '7.4.0'
pod install
コマンドを実行して、SDK をインストールします。コマンドを実行すると、*.xcworkspace ファイルが生成されます。これは、SDK が統合されていることを示します。
SDK を手動で統合する
App Store に動的フレームワークを送信する前に、x86 ベースのシミュレータアーキテクチャの動的フレームワークを削除する必要があります。 動的フレームワークを削除しないと、送信は App Store によって拒否されます。 CocoaPods を使用して SDK を統合すると、x86 ベースのシミュレータアーキテクチャの動的フレームワークは自動的に削除されます。
コンパイル中にエラーが発生した場合は、次の操作を実行します。Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [ビルド設定] タブをクリックします。 [ビルド設定] タブの [Apple Clang - 言語] セクションで、[ソースのコンパイル方法] パラメーターを [Objective-C++] に設定します。
ビジネスシナリオに基づいて、iOS 用の SDK をダウンロードして解凍します。
SDK の依存関係を追加します。
Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [全般] タブをクリックします。 [全般] タブの [フレームワーク、ライブラリ、および埋め込みコンテンツ] セクションで、
AliVCSDK_***.framework
およびalivcffmpeg.framework
の依存関係をインポートし、各依存関係の [埋め込み] 列の値を [埋め込みと署名] に設定します。 ビジネス要件に基づいて他の SDK 依存関係をインポートすることもできます。他の依存関係を追加します。
Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [全般] タブをクリックします。 [全般] タブの [フレームワーク、ライブラリ、および埋め込みコンテンツ] セクションで、
MobileCoreServices.framework
、SystemConfiguration.framework
、CoreTelephony.framework
、CoreMedia.framework
、VideoToolbox.framework
、AVFoundation.framework
、およびlibresolv.tbd
の依存関係をインポートします。SDK パッケージにリソースバンドルが含まれている場合は、リソースバンドルを追加します。
AliyunVideoSDKPro.bundle
リソースバンドルを Xcode プロジェクトにインポートします。
ステップ 2:SDK ライセンスを設定する
ApsaraVideo MediaBox SDK に初めてアクセスするときは、ライセンスを購入し、アプリケーションにバインドする必要があります。
ステップ 3:権限を設定する
Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [ビルド設定] タブをクリックします。 [ビルド設定] タブの [リンク] セクションで、[その他のリンカーフラグ] を選択し、-ObjC を設定します。
Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [ビルド設定] タブをクリックします。 [ビルド設定] タブの [ビルドオプション] セクションで、[ビットコードを有効にする] パラメーターを [いいえ] に設定します。
Info.plist ファイルを変更して、権限を設定します。
Privacy - Camera Usage Description Privacy - Microphone Usage Description Privacy - Photo Library Usage Description
FAQ
詳細については、「FAQ」をご参照ください。