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

Apsara Video SDK:iOS

最終更新日:Jan 13, 2026

この Topic では、さまざまなビジネスシナリオに応じて、iOS でオーディオ/ビデオ向け MediaBox SDK をクイックに統合する方法について説明します。

注意事項

SDK v6.6.0 以前から v6.7.0 以降にアップグレードする場合は、「オーディオ/ビデオ向けメディア SDK V6.7.0 の美顔エフェクトに関する統合変更のお知らせ」をご参照ください。

環境要件

カテゴリ

説明

macOS

macOS High Sierra 10.13 以降。

Xcode

この Topic の手順は Xcode に基づいています。Xcode からダウンロードしてください。

iOS バージョン

iOS 9.0 以降。

ステップ 1: SDK の統合

CocoaPods を使用した統合 (推奨)

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

  2. Podfile を変更して、SDK の依存関係を追加します。

    この Topic に記載されている SDK のバージョン番号は参考用です。最新バージョンについては、「シナリオ別 SDK」をご参照ください。

    # ビジネスシナリオに応じて、以下の 4 つの SDK から 1 つを選択して統合します。
    
    #1. オールインワン SDK: 再生、超低遅延ライブストリーミング、ライブストリーミング、ショートビデオ、リアルタイムコミュニケーション (RTC) 共同ストリーミング、および基本的な美顔をサポートします。
    pod 'AliVCSDK_Standard', '7.10.0'
    #2. Basic Live SDK: 再生、アップストリーミング、基本的な美顔、および超低遅延ライブストリーミングをサポートします。
    pod 'AliVCSDK_BasicLive', '7.10.0'   
    #3. Short Video SDK: 再生、ショートビデオ、および基本的な美顔をサポートします。
    pod 'AliVCSDK_UGC', '7.10.0'  
    #4. Interactive Live SDK: 再生、超低遅延ライブストリーミング、アップストリーミング、RTC 共同ストリーミング、および基本的な美顔をサポートします。
    pod 'AliVCSDK_InteractiveLive', '7.10.0'
  3. pod install コマンドを実行して SDK をインストールします。

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

SDK の手動統合

説明
  • App Store にアプリを提出する前に、動的ライブラリからエミュレーター用の x86 アーキテクチャを削除する必要があります。そうしないと、提出が拒否されます。この手順は、CocoaPods を使用して SDK を統合する場合、自動的に処理されます。

  • コンパイルエラーが発生した場合は、Xcode プロジェクトで [Targets] > [Build Settings] > [Apple Clang - Language] > [Compile Sources As] に移動し、値を [Objective-C++] に設定します。

  1. 必要な iOS 向けのシナリオ別 SDK をダウンロードして解凍します。

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

    Xcode プロジェクトで [Targets] > [General] > [Frameworks, Libraries, and Embedded Content] に移動します。AliVCSDK_***.frameworkalivcffmpeg.framework の依存関係をインポートします。必要に応じて、SDK パッケージから他の依存関係をインポートします。インポートした各依存関係について、[Embed][Embed & Sign] に設定します。

  3. 他のライブラリの依存関係を追加します。

    Xcode プロジェクトで [Targets] > [General] > [Frameworks, Libraries, and Embedded Content] に移動します。MobileCoreServices.frameworkSystemConfiguration.frameworkCoreTelephony.frameworkCoreMedia.frameworkVideoToolbox.frameworkAVFoundation.framework、および libresolv.tbd の依存関係をインポートします。

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

    AliyunVideoSDKPro.bundle の依存関係をプロジェクトにインポートします。

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

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

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

  1. Xcode プロジェクトで [Targets] > [Build Settings] > [Linking] > [Other Linker Flags] に移動し、[-ObjC] リンカーオプションを追加します。

  2. Xcode プロジェクトで [Targets] > [Build Settings] > [Build Options] > [Enable Bitcode] に移動し、値を [NO] に設定します。

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

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

よくある質問

詳細については、「よくある質問」の機能別のセクションをご参照ください。