全部產品
Search
文件中心

ApsaraVideo Live:整合iOS端美顏特效SDK

更新時間:Feb 06, 2026

美顏特效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' 

本地整合方式

  1. 下載並解壓Sample樣本工程,擷取以下framework。

    queen.framework
    opencv2.framework
    重要

    lite版本不需要opencv2.framework

  2. 開啟Xcode,在工程targetGeneral頁簽下,在Frameworks, Libraries, and Embedded Content地區中添加以上framework,並將添加framework的Embed屬性設定為Embed & Sign

  3. 在工程targetBuild Settings頁簽下,搜尋找到ENABLE_BITCODE一項,將其設定成NO

  4. 將擷取到的queen.framework中的mnn.metallib添加到工程目錄中(只有full版本和ultimate版本需要)。

配置License

請提前擷取License,擷取方式請參見擷取美顏特效SDK License。擷取後參考以下步驟將LicenseKey和LicenseFile(認證檔案)配置到工程中。

說明
  • 當您同時整合ApsaraVideo for Live美顏特效SDK和ApsaraVideo for VOD短視頻SDK時,兩者的LicenseKey和LicenseFile(認證檔案)是相同的,只需配置一次即可(注意認證檔案需使用最新的一份)。

  • 如果您購買的SDK版本發生變更或需要續期(SDK到期),需要更新認證檔案。更新步驟如下:

    1. 重新擷取Licence,操作請參見擷取美顏特效SDK License發送郵件擷取最新認證檔案。

    2. 擷取最新認證後,執行本文中配置License步驟更新認證。

將認證檔案匯入App工程,在Info.plist檔案中添加兩個Key

  • 第一個KeyAlivcLicenseKeyvalue為LicenseKey的值。樣本:MoCTfuQ391Z01****8f8745e23c8a457a8ff8d5faedc1****

  • 第二個KeyAlivcLicenseFilevalue為認證檔案(相對於mainBundle)的路徑,樣本:AliVideoCert_164933454****.crt。

參考資料

專案

連結

Sample樣本工程

Sample樣本工程

在GitHub上提供的Demo工程

Demo工程

常見SDK廠家接入示範,供開發人員參考。