すべてのプロダクト
Search
ドキュメントセンター

Apsara Video SDK:iOS

最終更新日:Jul 05, 2025

このトピックでは、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 を統合する

  1. プロジェクトディレクトリで pod init コマンドを実行して、Podfile を作成します。

  2. 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'
  3. pod install コマンドを実行して、SDK をインストールします。

    コマンドを実行すると、*.xcworkspace ファイルが生成されます。これは、SDK が統合されていることを示します。

SDK を手動で統合する

説明
  • App Store に動的フレームワークを送信する前に、x86 ベースのシミュレータアーキテクチャの動的フレームワークを削除する必要があります。 動的フレームワークを削除しないと、送信は App Store によって拒否されます。 CocoaPods を使用して SDK を統合すると、x86 ベースのシミュレータアーキテクチャの動的フレームワークは自動的に削除されます。

  • コンパイル中にエラーが発生した場合は、次の操作を実行します。Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [ビルド設定] タブをクリックします。 [ビルド設定] タブの [Apple Clang - 言語] セクションで、[ソースのコンパイル方法] パラメーターを [Objective-C++] に設定します。

  1. ビジネスシナリオに基づいて、iOS 用の SDK をダウンロードして解凍します。

  2. SDK の依存関係を追加します。

    Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [全般] タブをクリックします。 [全般] タブの [フレームワーク、ライブラリ、および埋め込みコンテンツ] セクションで、AliVCSDK_***.framework および alivcffmpeg.framework の依存関係をインポートし、各依存関係の [埋め込み] 列の値を [埋め込みと署名] に設定します。 ビジネス要件に基づいて他の SDK 依存関係をインポートすることもできます。

  3. 他の依存関係を追加します。

    Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [全般] タブをクリックします。 [全般] タブの [フレームワーク、ライブラリ、および埋め込みコンテンツ] セクションで、MobileCoreServices.frameworkSystemConfiguration.frameworkCoreTelephony.frameworkCoreMedia.frameworkVideoToolbox.frameworkAVFoundation.framework、および libresolv.tbd の依存関係をインポートします。

  4. SDK パッケージにリソースバンドルが含まれている場合は、リソースバンドルを追加します。

    AliyunVideoSDKPro.bundle リソースバンドルを Xcode プロジェクトにインポートします。

ステップ 2:SDK ライセンスを設定する

ApsaraVideo MediaBox SDK に初めてアクセスするときは、ライセンスを購入し、アプリケーションにバインドする必要があります。

ステップ 3:権限を設定する

  1. Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [ビルド設定] タブをクリックします。 [ビルド設定] タブの [リンク] セクションで、[その他のリンカーフラグ] を選択し、-ObjC を設定します。

  2. Xcode プロジェクトで、[TARGETS] ディレクトリを開きます。 [ビルド設定] タブをクリックします。 [ビルド設定] タブの [ビルドオプション] セクションで、[ビットコードを有効にする] パラメーターを [いいえ] に設定します。

  3. Info.plist ファイルを変更して、権限を設定します。

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

FAQ

詳細については、「FAQ」をご参照ください。