すべてのプロダクト
Search

このプロダクト

    Apsara Video SDK:iOS

    ドキュメントセンター

    Apsara Video SDK:iOS

    最終更新日:Dec 06, 2025

    このトピックでは、さまざまなビジネスシナリオに合わせて、iOS 向け音声・動画用 MediaBox SDK をクイックに統合する方法について説明します。

    注意事項

    v6.6.0 以前の SDK バージョンから v6.7.0 以降にアップグレードする場合は、「音声・動画端末 SDK V6.7.0 における美顔・エフェクト機能の統合変更に関するお知らせ」をご参照ください。

    前提条件

    カテゴリ

    説明

    macOS

    macOS High Sierra 10.13 以降。

    Xcode

    このトピックの手順は Xcode に基づいています。ダウンロード先：Xcode。

    iOS バージョン

    iOS 9.0 以降。

    ステップ 1：SDK の統合

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

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

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

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

      # ビジネスニーズに応じて、以下の 4 つの SDK のいずれかを選択して統合します。

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

    3. pod install コマンドを実行して SDK をインストールします。

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

    SDK の手動統合

    説明

    • App Store にアプリを提出するには、動的ライブラリのエミュレーターバージョン (x86 アーキテクチャ) を削除する必要があります。削除しない場合、提出は拒否されます。CocoaPods による統合方法では、この処理が自動的に行われます。

    • コンパイルエラーが発生した場合は、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_***.framework と alivcffmpeg.framework の依存関係をインポートします。必要に応じて、SDK パッケージから他の依存関係をインポートします。[Embed] を [Embed & Sign] に設定します。

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

      Xcode プロジェクトで [Targets] > [General] > [Frameworks, Libraries, And Embedded Content] に移動します。MobileCoreServices.framework、SystemConfiguration.framework、CoreTelephony.framework、CoreMedia.framework、VideoToolbox.framework、AVFoundation.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

    よくある質問

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