本文為您介紹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方式整合
在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' //專業版整合
更新pod repo。
pod repo update安裝pod。
pod install
設定項目
SDK整合後,開啟專案工程並修改以下配置:
配置Build Setting > Linking > Other Linker Flags ,添加-ObjC。
開啟工程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)的路徑。 |
後續步驟
播放器整合
如果您需要同時整合iOS端短視頻SDK和播放器SDK至您的專案中,建議您使用iOS端一體化SDK進行整合。否則,可能會出現類重複的問題,從而導致編譯失敗。