ApsaraVideo MediaBox SDK for iOS を迅速に統合する方法 - Apsara Video SDK

このトピックでは、さまざまなビジネスシナリオに応じて ApsaraVideo MediaBox SDK for iOS を迅速に統合する方法について説明します。

重要

SDK v6.6.0 以前から v6.7.0 以降にアップグレードする場合は、「ApsaraVideo MediaBox SDK V6.7.0 の統合レタッチ効果に関する更新」をご参照ください。

前提条件

項目	説明
macOS	macOS High Sierra 10.13 以降。
Xcode	このトピックの手順では Xcode を使用します。Xcode からダウンロードできます。
iOS バージョン	iOS 9.0 以降。

ステップ 1： SDK の統合

Pod 統合 (推奨)

プロジェクトディレクトリで pod init を実行して Podfile を作成します。

SDK の依存関係を Podfile に追加します。

以下のコード内の SDK バージョンは一例です。最新バージョンについては、「シナリオ別 SDK」をご参照ください。

# ビジネスシナリオに基づいて、次の 4 つの SDK のいずれかを統合します。

# 1. 標準オールインワン SDK： プレーヤー + リアルタイムストリーミング (RTS) + 標準ライブストリーミング + ショートビデオ + リアルタイム通信 (RTC) ライブ連携 + 基本レタッチ
pod 'AliVCSDK_Standard', '7.11.0'
# 2. 基本ライブストリーミング SDK： プレーヤー + アップストリーミング + 基本レタッチ + リアルタイムストリーミング (RTS)
pod 'AliVCSDK_BasicLive', '7.11.0'   
# 3. ショートビデオシナリオ SDK： プレーヤー + ショートビデオ + 基本レタッチ
pod 'AliVCSDK_UGC', '7.11.0'  
# 4. インタラクティブライブストリーミング SDK： プレーヤー + リアルタイムストリーミング (RTS) + アップストリーミング + リアルタイム通信 (RTC) ライブ連携 + 基本レタッチ
pod 'AliVCSDK_InteractiveLive', '7.11.0'

pod install コマンドを実行して SDK をインストールします。
コマンドの実行後、.xcworkspace ファイルが生成されます。このファイルが存在すれば、SDK の統合は完了です。

手動統合

説明

App Store にアプリを提出する前に、動的フレームワークからシミュレーター用の x86 アーキテクチャを削除する必要があります。そうしないと、提出が拒否されます。Pod 統合では、この処理が自動的に行われます。
コンパイルエラーが発生した場合は、Xcode プロジェクトで [TARGETS] > [Build Settings] > [Apple Clang - Language] に移動し、[Compile Sources As] を [Objective-C++] に設定します。

必要な iOS 向けシナリオ SDK をダウンロードして解凍します。
SDK の依存関係を追加します。
Xcode プロジェクトで、[TARGETS] > [General] > [Frameworks, Libraries, and Embedded Content] に移動します。SDK パッケージから AliVCSDK_***.framework、alivcffmpeg.framework、およびその他の必要な依存関係を追加します。インポートされた各依存関係について、[Embed] オプションを [Embed & Sign] に設定します。
他のライブラリ依存関係を追加します。
Xcode プロジェクトで、[TARGETS] > [General] > [Frameworks, Libraries, and Embedded Content] に移動します。MobileCoreServices.framework、SystemConfiguration.framework、CoreTelephony.framework、CoreMedia.framework、VideoToolbox.framework、AVFoundation.framework、および libresolv.tbd の依存関係をインポートします。
リソースバンドルを追加します (SDK パッケージに含まれている場合)。
プロジェクトに AliyunVideoSDKPro.bundle リソースバンドルを追加します。

ステップ 2：ライセンス認証の設定

初めて SDK を統合する場合は、ライセンスを管理し、ライセンス認証を設定する必要があります。

ステップ 3：アプリ権限の設定

Xcode プロジェクトで、[TARGETS] > [Build Settings] > [Linking] に移動します。[Other Linker Flags] フィールドに、-ObjC オプションを追加します。
Xcode プロジェクトで、[TARGETS] > [Build Settings] > [Build Options] に移動し、[Enable Bitcode] を [NO] に設定します。

Info.plist ファイルを編集して、アプリの権限を設定します。

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

よくある質問

トラブルシューティングについては、「よくある質問」の機能別セクションをご参照ください。

重要