美顏特效SDK是由阿里視頻雲團隊提供的美顏特效功能,支援畫面美化、人像美顏、摳像製作、貼紙美妝、動作識別、美體、美髮、AR隔空寫字等各種個人化定製服務,適用於ApsaraVideo for Live、視頻會議、短視頻製作等情境。本文為您介紹iOS端美顏特效SDK的整合操作,用於實現美顏特效功能。
前提條件
開發前的環境要求如下表所示。
類別 | 說明 |
系統版本 | 支援iOS 9.0及以上版本。 |
macOS High Sierra版本 | 支援macOS High Sierra 10.13及以上版本。 |
Xcode版本 | 支援Xcode 9.0及以上版本,下載Xcode。 |
iOS裝置 | armv7或arm64的行動裝置,如iPad或iPhone,不包含支援arm64架構的Mac。 |
整合方式
支援pods和本地整合兩種方式,您可根據需求自行選擇合適的整合方式。
pods整合方式
pods整合方式如下:
pod 'Queen', '6.1.0-official-pro' 本地整合方式
下載並解壓Sample樣本工程,擷取以下framework。
queen.framework opencv2.framework重要lite版本不需要
opencv2.framework。開啟Xcode,在工程target的General頁簽下,在Frameworks, Libraries, and Embedded Content地區中添加以上framework,並將添加framework的Embed屬性設定為Embed & Sign。
在工程target的Build Settings頁簽下,搜尋找到ENABLE_BITCODE一項,將其設定成NO。
將擷取到的
queen.framework中的mnn.metallib添加到工程目錄中(只有full版本和ultimate版本需要)。
配置License
請提前擷取License,擷取方式請參見擷取美顏特效SDK License。擷取後參考以下步驟將LicenseKey和LicenseFile(認證檔案)配置到工程中。
當您同時整合ApsaraVideo for Live美顏特效SDK和ApsaraVideo for VOD短視頻SDK時,兩者的LicenseKey和LicenseFile(認證檔案)是相同的,只需配置一次即可(注意認證檔案需使用最新的一份)。
如果您購買的SDK版本發生變更或需要續期(SDK到期),需要更新認證檔案。更新步驟如下:
重新擷取Licence,操作請參見擷取美顏特效SDK License發送郵件擷取最新認證檔案。
擷取最新認證後,執行本文中配置License步驟更新認證。
將認證檔案匯入App工程,在Info.plist檔案中添加兩個Key。
第一個
Key為AlivcLicenseKey,value為LicenseKey的值。樣本:MoCTfuQ391Z01****8f8745e23c8a457a8ff8d5faedc1****。第二個
Key為AlivcLicenseFile,value為認證檔案(相對於mainBundle)的路徑,樣本:AliVideoCert_164933454****.crt。
參考資料
專案 | 連結 |
Sample樣本工程 | |
在GitHub上提供的Demo工程 | |
常見SDK廠家接入示範,供開發人員參考。 |