RTC 和智能美颜特效产品（CV 产品）深度融合，你可以通过调用 RTC SDK 提供的美颜处理接口，快速接入 CV 功能，比自行集成 CV 产品更方便更健壮。通过 CV 功能，你可以对本地采集的视频添加美颜、滤镜、贴纸等特效。
查看本文档，了解如何在 RTC 应用中接入 CV 功能。

前置条件

已集成了 3.21.1 及以上版本的 RTC SDK
RTC 最新版本均支持本文档的集成方案，为保证你可以体验所有新增特性，建议使用最新版本 RTC SDK。
已在项目中通过 RTC SDK 实现 RTC 视频通话功能
已通过以下渠道之一获取 CV SDK：
- 下载最新版 RTC 进阶功能 Demo 工程文件，其中包含了 CV SDK
- 由 CV 技术服务人员提供的 CV 4.1.0.3 及以后的 Standard 和 Lite 版本
联系 CV 技术服务人员获取符合业务功能需求的 CV License 和 CV 素材资源包
操作系统需满足以下要求：
- Android: Android 5.0+
- iOS: iOS 9+（不支持模拟器）
- macOS: macOS 10.10+
- Windows: Win 7+

操作步骤

1. 将 CV SDK 添加到项目中，并集成

参看项目中加入 SDK 和代码中集成 SDK。

集成注意事项

iOS

CV SDK 和 RTC SDK 可以按需提供动态库/静态库打包版本。RTC 强烈建议：在集成时，对于 CV SDK 和 ByteRTC SDK，均采用动态库。此时，你无需修改项目的编译配置。

不同的集成方式，参看如何集成 CV SDK 动态库？和如何集成 CV SDK 静态库？。

Android

开发 Android 应用时需进行混淆配置，具体设置参看在开发 Android 应用时，如何进行混淆配置？

Windows

在前置条件基础上，需要将对应平台的 CV SDK 以及算法资源包 cvlab 文件夹拷贝到可执行程序所在目录。
PC 集成 CV SDK 需要发送 http 请求进行鉴权，鉴权成功返回证书，然后调用 CheckLicense 对证书有效性进行验证，另外请求返回的证书可以缓存到本地，下次直接用返回的证书进行验证。具体参考在线授权说明。

2. 调用 RTC API 实现 CV 功能

API 调用时序图

以 Android 为例，采用 RTC SDK 内部视频采集方案时，API 调用时序可以参考下图：

alt

API 参考

序号	业务逻辑	Android	iOS	Mac	Windows	备注
1	检查视频特效许可证	`checkVideoEffectLicense`	`checkVideoEffectLicense:`	`checkVideoEffectLicense:`	`checkLicense`	关于许可证的相关问题，参看授权相关。
2	设置视频特效算法模型路径	`setVideoEffectAlgoModelPath`	`setVideoEffectAlgoModelPath:`	`setVideoEffectAlgoModelPath:`	`setAlgoModelPath`	---
3	创建/销毁视频特效引擎	`enableVideoEffect`	`enableVideoEffect:`	`enableVideoEffect:`	`enableEffect`	---
4	设置美颜、贴纸特效包，支持叠加设置	`setVideoEffectNodes`	`setVideoEffectNodes:`	`setVideoEffectNodes:`	`setEffectNodes`	---
5	设置美颜特效强度	`updateVideoEffectNode`	`updateVideoEffectNode:nodeKey:nodeValue:`	`updateVideoEffectNode:nodeKey:nodeValue:`	`updateNode`	你必须根据各个特效的情况，对特效强度进行设置
6	设置颜色滤镜	`setVideoEffectColorFilter`	`setVideoEffectColorFilter:`	`setVideoEffectColorFilter:`	`setColorFilter`	在选择滤镜素材时，请参看滤镜素材对应。
7	设置颜色滤镜强度	`setVideoEffectColorFilterIntensity`	`setVideoEffectColorFilterIntensity:`	`setVideoEffectColorFilterIntensity:`	`setColorFilterIntensity`	---
8	注册人脸检测观察者	`registerFaceDetectionObserver`	`registerFaceDetectionObserver:withInterval:`	`registerFaceDetectionObserver:withInterval:`	`registerFaceDetectionObserver`	---

3. 正式资源替换

测试完成之后、应用正式上线之前，你需要将测试使用的 CV License 与素材文件全部替换为正式资源，请向技术服务人员获取正式资源后，按如下步骤进行操作：
Step 1：将工程文件中的 CV 资源文件替换为正式的 CV License 与素材文件

Anrdoid: /Advanced_Demo/app/src/main/assets/cvlab
iOS: /Advanced_Demo/Advanced/Resource/EffectResource/
Windows: /Advanced_Demo/Resources/cvlab

alt
Step 2：将 LICENSE_NAME 修改为新的 CV License 的相对路径，替换完成可通过 checkVideoEffectLicense 确认许可证文件绝对路径是否正确。若替换后授权失败，参考 Android 授权操作指南并可同时尝试卸载重装 APP 或清理 APP 缓存。

注意事项

无论是否进房，只要开启视频采集，你都可以设置特效。
在音视频通话中，无论你使用的是 RTC SDK 内部采集，还是自定义视频采集，你都可以使用 CV SDK 添加视频特效。当你使用自定义视频采集方案，并使用 CV SDK 添加视频特效时，本地和远端看到的经 CV 处理后视频的参数（分辨率，帧率，码率等），取决于你通过 setVideoEncoderConfig 设置的视频参数。如果在低端机（如 iPhone5s）上设置过高的视频参数（如 720P），并开启美颜，可能会引起严重的卡顿和延时。
部分贴纸可能会因自带一定滤镜、美颜效果，从而使先前设置的滤镜、美颜失效。关于细节，咨询技术支持人员。
由于 CV SDK 尚未兼顾与 Android 11+ 平台适配问题，有可能因与 API 30 不兼容而导致应用崩溃。此时，你需将 targetSdkVersion 版本降到 30 以下，或者关闭指针标记功能，参看已加标记的指针。
调用接口后可能产生的错误码有：
- 1000: 未集成 CV SDK，或 iOS 使用静态库 CV SDK 时，符号未添加完整；
- 1001: 当前 RTC 版本不支持 CV 功能；
- <0: 透传的其他错误码，参看错误码表。