美颜特效SDK是由阿里视频云团队提供的美颜特效功能,支持画面美化、人像美颜、抠像制作、贴纸美妆、动作识别、美体、美发、AR隔空写字等各种个性化定制服务,适用于视频直播、视频会议、短视频制作等场景。本文为您介绍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(证书文件)配置到工程中。
当您同时集成视频直播美颜特效SDK和视频点播短视频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厂家接入示范,供开发者参考。 |