本文為您介紹iOS短視頻SDK的pod集成和手動配置操作。
前提條件
開發前的環境要求如下表所示。
類別 | 說明 |
系統版本 | 支持iOS 9.0及以上版本。 |
macOS High Sierra版本 | 支持macOS High Sierra 10.13及以上版本。 |
Xcode版本 | 支持Xcode 9.0及以上版本,下載Xcode。 |
背景信息
短視頻SDK分為專業版,標準版和基礎版,三個版本使用的庫名分別為專業版/標準版(AliyunVideoSDKPro.framework)和基礎版(AliyunVideoSDKBasic.framework)。
基礎版只包含錄制與裁剪模塊。
專業版和標準版包含全功能模塊,標準版的高級接口需要單獨授權才能調用。
短視頻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時,如果需要上傳媒資文件到視頻點播,請集成上傳SDK上傳,具體內容請參見上傳SDK。
版本
Podfile文件對應依賴
專業版
默認集成(默認集成方式,包含主庫、資源包和上傳SDK)
# 默認的集成形式,除SDK本身外,還會集成相關資源和上傳SDK pod 'AliyunVideoSDKPro', '~> 6.15.0'
最少依賴集成(不包含資源包和上傳SDK)
# 僅集成短視頻SDK,不會集成資源包和上傳SDK pod 'AliyunVideoSDKPro/min', '~> 6.15.0'
說明如需使用拍攝模塊的人臉貼紙功能,則必須引入資源包(AliyunVideoSDKPro.bundle),引入方式請參見設置資源包引入路徑。
標準版
默認集成(默認集成方式,包含主庫、資源包和上傳SDK)
# 默認的集成方式,除短視頻SDK外,還會集成上傳SDK。 pod 'AliyunVideoSDKStd', '~> 6.15.0'
最少依賴集成(不包含資源包和上傳SDK)
# 僅集成短視頻SDK pod 'AliyunVideoSDKStd/min', '~> 6.15.0'
基礎版
# 僅集成短視頻SDK pod 'AliyunVideoSDKBasic', '~> 6.15.0'
更新pod repo。
pod repo update
安裝pod。
pod install
手動方式集成(不推薦)
庫和資源依賴說明
手動方式集成不提供上傳庫,如果需要上傳媒資文件到視頻點播,請集成上傳SDK上傳,具體內容請參見上傳SDK。
專業版
需要手動下載集成相應版本的以下庫和bundle資源包。
庫名
描述
下載地址
AliyunVideoSDKPro.framework
動態庫
AETemplateEngune.framework
動態庫(非必須)
AliyunVideoSDKPro.bundle
資源包(非必須)
說明當需要使用拍攝模塊的人臉貼紙功能時,則必須引入該資源包。
alivcffmpeg
動態庫
標準版
需要手動下載集成相應版本的以下庫。
庫名
描述
下載地址
AliyunVideoSDKPro.framework
動態庫
alivcffmpeg
動態庫
基礎版
需要手動下載集成相應版本的以下庫。
庫名
描述
下載地址
AliyunVideoSDKBasic.framework
動態庫
alivcffmpeg
動態庫
操作步驟
手動方式集成較為繁瑣,并且提交到App Store時需要剝離模擬器版本(x86架構)的動態庫,否則會被拒絕。因此推薦使用pod方式集成。剝離模擬器動態庫的方式有如下兩種:
使用命令行工具lipo剝離模擬器架構的framework。
通過pod方式集成,pod會在打包時自動剝離掉模擬器架構的framework。
編譯報錯時,請修改
,修改為Objective-C++。
添加動態庫。
單擊General,選擇Frameworks, Libraries, and Embedded Content。單擊+,然后單擊Add Other…,導入上述動態庫(例如AliyunVideoSDKPro.framework、alivcffmpeg.framework)。導入之后請選擇Embed &Sign。
添加其他庫依賴。
單擊General,選擇Frameworks, Libraries, and Embedded Content。單擊+,分別添加MobileCoreServices.framework、SystemConfiguration.framework和libresolv.tbd依賴。
可選:將AliyunVideoSDKPro.bundle依賴導入到工程。
單擊Build Phases,選擇Copy Bundle Resources,單擊+,然后單擊Add Other…,導入AliyunVideoSDKPro.bundle。
配置項目
SDK集成后,打開項目工程并修改以下配置:
配置 ,添加-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)的路徑。 |