实时互动网
·
如何在iOS项目中集成美颜SDK？
内容提要
本文介绍了即构 AI 美颜 SDK（ZegoEffects SDK）在 iOS 端的集成流程，包括鉴权、资源导入、初始化和图像处理等关键步骤。集成前需确认系统要求和获取授权信息，建议使用在线鉴权。资源导入时需注意文件路径配置，初始化时确保图像分辨率匹配，处理过程中可实时调整美颜参数。与音视频 SDK 协同使用可实现无缝对接。
关键要点
-
iOS 端的美颜 SDK 集成相对 Android 端简单，主要流程包括鉴权、资源导入、图像管线对接。
-
集成前需确认最低系统要求为 iOS 13.0，并在 ZEGO 控制台获取 AppID 和 AppSign。
-
建议使用 CocoaPods 导入 SDK，以便于后续版本更新管理。
-
即构 ZegoEffects 支持在线和离线两种鉴权方式，建议新手从在线鉴权开始。
-
导入资源时需确保正确添加到 Xcode 项目的 Copy Bundle Resources 中，避免运行时错误。
-
初始化时需传入待处理图像的分辨率，确保与视频采集分辨率一致。
-
图像处理循环中需将视频数据送入 processImageBuffer 接口，支持 BGRA32 和 RGBA32 格式。
-
与音视频 SDK 协同使用时，ZegoEffects 的美颜处理可无缝衔接到 Express SDK 的编码和推流管线。
-
集成的四个关键步骤为：鉴权配置、资源导入、初始化时机、图像处理管线。
延伸解读
集成前的准备工作
在集成即构 ZegoEffects SDK 之前，确保满足最低系统要求 iOS 13.0，并在 ZEGO 控制台获取 AppID 和 AppSign。特别注意申请美颜功能的 License，以免后续使用中出现权限问题。
资源导入的注意事项
导入资源时，务必将所需的 bundle 文件正确添加到 Xcode 的 Copy Bundle Resources 中。遗漏或错误配置将导致运行时错误，影响美颜功能的正常使用。
初始化时机的重要性
建议在摄像头启动之前完成 SDK 的初始化，以确保用户打开摄像头时美颜效果已准备就绪。这样可以避免第一帧出现无美颜效果的情况，提升用户体验。
与音视频 SDK 的协同使用
如果同时使用即构的 Express SDK 和 ZegoEffects SDK，二者可以无缝衔接，避免像素格式转换和内存拷贝。这种协同使用可以提高性能和简化集成流程，值得开发者关注。
延伸问答
如何在iOS项目中集成即构美颜SDK？
集成即构美颜SDK的步骤包括鉴权配置、资源导入、初始化时机和图像处理管线。
集成即构美颜SDK前需要准备哪些信息？
需要确认最低系统要求为iOS 13.0，并在ZEGO控制台获取AppID和AppSign，申请美颜功能的License。
即构美颜SDK支持哪些鉴权方式？
即构美颜SDK支持在线和离线两种鉴权方式，建议新手从在线鉴权开始。
在导入资源时需要注意什么？
确保资源文件正确添加到Xcode项目的Copy Bundle Resources中，以避免运行时错误。
初始化美颜SDK时需要传入什么参数？
初始化时需要传入待处理图像的分辨率，确保与视频采集分辨率一致。
如何在图像处理循环中使用美颜SDK？
在摄像头的视频帧回调中，将每一帧的视频数据送入processImageBuffer接口进行处理。
