全部產品
Search
文件中心

ApsaraVideo VOD:整合SDK

更新時間:Jan 29, 2026

本文為您介紹iOS短視頻SDK的pod整合。

前提條件

開發前的環境要求如下表所示。

類別

說明

系統版本

支援iOS 9.0及以上版本。

macOS High Sierra版本

支援macOS High Sierra 10.13及以上版本。

Xcode版本

支援Xcode 9.0及以上版本,下載Xcode

背景資訊

短視頻SDK分為專業版,標準版和基礎版,三個版本都使用庫(AliVCSDK_ShortVideo.framework),請根據不同需求開通不同license。

  • 基礎版只包含錄製與裁剪模組。

  • 專業版和標準版包含全功能模組,標準版的進階介面需要單獨授權才能調用。

說明

短視頻SDK的功能更新,請參見發布說明

整合說明

  • 如果有同時使用短視頻SDK和播放器SDK的需求,建議您整合音視頻一體化產品MediaBox音視頻SDK,可有效解決單獨整合多款SDK時引起的依賴庫衝突問題。整合操作,請參見iOS端

  • 如需同時單獨整合短視頻SDK和播放器SDK,您需要關注短視頻SDK、播放器SDK及AlivcFFmpeg的版本依賴關係,否則會導致短視頻或播放器的功能使用失敗,詳細資料,請參見AlivcFFmpeg版本依賴

pod方式整合

  1. 在Podfile檔案中添加依賴,各版本依賴如下所示:

    重要
    • 如果使用短視頻SDK 3.24.0及以上版本,請務必使用FFmpeg 4.3.0及以上版本。

    • 請確保網路環境可以訪問更新pod倉庫,並在pod install安裝完成後檢查framework版本號碼是否和官網最新版一致。

    • 使用最少依賴整合方式整合短視頻SDK時,如果需要上傳媒資檔案到ApsaraVideo for VOD,請整合上傳SDK上傳,具體內容請參見上傳SDK

    • V7.0.0及以上版本整合

      pod 'AliVCSDK_ShortVideo', '~> 7.10.0'
    • V6.21.0及以下版本整合

      pod 'AliyunVideoSDKBasic', '~> 6.21.0' //基礎版整合
      pod 'AliyunVideoSDKStd', '~> 6.21.0'	//標準版整合
      pod 'AliyunVideoSDKPro', '~> 6.21.0'	//專業版整合
  2. 更新pod repo。

    pod repo update
  3. 安裝pod。

    pod install

設定項目

SDK整合後,開啟專案工程並修改以下配置:

  1. 配置Build Setting > Linking > Other Linker Flags ,添加-ObjC。

  2. 開啟工程info.Plist,添加以下許可權:

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

配置License

擷取到License後,需要按以下操作配置License檔案。License的擷取及詳細資料請參見擷取短視頻SDK License

把下載的License檔案匯入到App工程中,在Info.plist檔案中添加兩個key,第一個key為AlivcLicenseKey,value為LicenseKey的值;第二個key為AlivcLicenseFile,value為內建認證檔案(相對於mainBundle)的路徑。樣本如下所示:

key

value

AlivcLicenseKey

LicenseKey的值。取值樣本:MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****

AlivcLicenseFile

內建認證檔案(相對於mainBundle)的路徑。

後續步驟

初始化SDK

播放器整合

如果您需要同時整合iOS端短視頻SDK和播放器SDK至您的專案中,建議您使用iOS端一體化SDK進行整合。否則,可能會出現類重複的問題,從而導致編譯失敗。

相關文檔