全部產品
Search
文件中心

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及以上版本。

步驟一:整合SDK

pod整合(推薦)

  1. 在專案目錄下執行命令pod init,建立Podfile檔案。

  2. 修改Podfile檔案,添加SDK依賴。

    本文中引入的SDK版本號碼僅供參考,擷取最新的版本請參見情境SDK

    #下面4種情境組合,請根據自己的業務需要,選擇一種接入即可
    
    #1.標準一體化SDK:播放器 + 超低延遲直播 + 直播 + 短視頻 + RTC連麥 + 基礎美顏
    pod 'AliVCSDK_Standard', '7.9.1'
    #2.基礎直播SDK:播放器 + 直播推流 + 基礎美顏 + 超低延遲直播
    pod 'AliVCSDK_BasicLive', '7.9.1'   
    #3.短視頻情境SDK:播放器 + 短視頻 + 基礎美顏
    pod 'AliVCSDK_UGC', '7.9.1'  
    #4.互動直播SDK:播放器 + 超低延遲直播 + 直播推流 + RTC連麥 + 基礎美顏
    pod 'AliVCSDK_InteractiveLive', '7.9.1'
  3. 執行命令pod install,安裝SDK。

    命令執行完成之後,會產生*.xcworkspace檔案,表示SDK整合完畢。

手動整合

說明
  • 提交到App Store時需要剝離模擬器版本(x86架構)的動態庫,否則會被拒絕。pod整合方式已自動處理。

  • 如遇編譯報錯時,在Xcode工程中Tergets > Build Settings > Apple Clang - Language > Compile Sources As,配置為Objective-C++

  1. 下載並解壓iOS端指定情境SDK

  2. 添加SDK依賴。

    在Xcode工程中Tergets > General > Frameworks, Libraries, and Embedded Content,匯入AliVCSDK_***.frameworkalivcffmpeg.framework依賴(按需匯入SDK包中的其他依賴),並將對應Embed選擇為Embed & Sign

  3. 添加其他庫依賴。

    在Xcode工程中Tergets > General > Frameworks, Libraries, and Embedded Content,匯入MobileCoreServices.frameworkSystemConfiguration.frameworkCoreTelephony.frameworkCoreMedia.frameworkVideoToolbox.frameworkAVFoundation.frameworklibresolv.tbd依賴。

  4. 添加資源套件(如果SDK包有)。

    AliyunVideoSDKPro.bundle依賴匯入到工程。

步驟二:配置License授權

首次接入SDK,需要管理License配置License授權

步驟三:配置App許可權

  1. 在Xcode工程中Tergets > Build Settings > linking > Other Linker Flags,添加-ObjC連結選項。

  2. 在Xcode工程中Tergets > Build Settings > Build Options > Enable Bitcode,配置為NO

  3. 修改Info.plist檔案,配置App許可權。

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

常見問題

請參見常見問題下各功能模組章節。