All Products
Search

This Product

    Apsara Video SDK:Integrate the SDK for iOS

    Document Center

    Apsara Video SDK:Integrate the SDK for iOS

    Last Updated:Apr 22, 2026

    This topic shows you how to quickly integrate the ApsaraVideo MediaBox SDK for iOS for different business scenarios.

    Important

    If you are upgrading from SDK v6.6.0 or earlier to v6.7.0 or later, see Updates on the integrated retouching effects of ApsaraVideo MediaBox SDK V6.7.0.

    Prerequisites

    Item

    Description

    macOS

    macOS High Sierra 10.13 or later.

    Xcode

    The steps in this topic use Xcode. You can download it from Xcode.

    iOS version

    iOS 9.0 or later.

    Step 1: Integrate the SDK

    pod integration (Recommended)

    1. In your project directory, run pod init to create a Podfile.

    2. Add the SDK dependency to the Podfile.

      The SDK version in the following code is an example. For the latest version, see scenario SDKs.

      # Integrate one of the following four SDKs based on your business scenario.

# 1. Standard all-in-one SDK: player + real-time streaming (RTS) + standard live streaming + short video + real-time communication (RTC) co-streaming + basic retouching
pod 'AliVCSDK_Standard', '7.11.0'
# 2. Basic live streaming SDK: player + live stream ingest + basic retouching + real-time streaming (RTS)
pod 'AliVCSDK_BasicLive', '7.11.0'   
# 3. Short video scenario SDK: player + short video + basic retouching
pod 'AliVCSDK_UGC', '7.11.0'  
# 4. Interactive live streaming SDK: player + real-time streaming (RTS) + live stream ingest + real-time communication (RTC) co-streaming + basic retouching
pod 'AliVCSDK_InteractiveLive', '7.11.0'

    3. Run the pod install command to install the SDK.

      After the command runs, a .xcworkspace file is generated. The presence of this file indicates that the SDK integration is complete.

    Manual integration

    Note

    • Before you submit your app to the App Store, you must strip the x86 architecture for simulators from the dynamic frameworks. Otherwise, your submission will be rejected. Pod integration handles this automatically.

    • If a compilation error occurs, go to TARGETS > Build Settings > Apple Clang - Language in your Xcode project and set Compile Sources As to Objective-C++.

    1. Download and decompress the required scenario SDK for iOS.

    2. Add the SDK dependencies.

      In your Xcode project, go to TARGETS > General > Frameworks, Libraries, and Embedded Content. Add the AliVCSDK_***.framework, alivcffmpeg.framework, and other required dependencies from the SDK package. For each imported dependency, set the Embed option to Embed & Sign.

    3. Add other library dependencies.

      In your Xcode project, go to TARGETS > General > Frameworks, Libraries, and Embedded Content. Import the MobileCoreServices.framework, SystemConfiguration.framework, CoreTelephony.framework, CoreMedia.framework, VideoToolbox.framework, AVFoundation.framework, and libresolv.tbd dependencies.

    4. Add the resource bundle (if one is included in the SDK package).

      Add the AliyunVideoSDKPro.bundle resource bundle to your project.

    Step 2: Configure license authorization

    For first-time SDK integration, you must manage the license and configure license authorization.

    Step 3: Configure app permissions

    1. In your Xcode project, go to TARGETS > Build Settings > Linking. In the Other Linker Flags field, add the -ObjC option.

    2. In your Xcode project, go to TARGETS > Build Settings > Build Options and set Enable Bitcode to NO.

    3. Modify the Info.plist file to configure app permissions.

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

    FAQ

    For troubleshooting, see the feature-specific sections in FAQ.