文档

集成iOS端美颜特效SDK

更新时间:

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

本地集成方式

  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(证书文件)配置到工程中。

说明
  • 当您同时集成视频直播美颜特效SDK和视频点播短视频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厂家接入示范,供开发者参考。