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+

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

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

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

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

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

测试完成之后、应用正式上线之前，你需要将测试使用的 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

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

• 无论是否进房，只要开启视频采集，你都可以设置特效。

• 在音视频通话中，无论你使用的是 RTC SDK 内部采集，还是自定义视频采集，你都可以使用 CV SDK 添加视频特效。当你使用自定义视频采集方案，并使用 CV SDK 添加视频特效时，本地和远端看到的经 CV 处理后视频的参数（分辨率，帧率，码率等），取决于你通过 setVideoEncoderConfig 设置的视频参数。如果在低端机（如 iPhone5s）上设置过高的视频参数（如 720P），并开启美颜，可能会引起严重的卡顿和延时。

• 部分贴纸可能会因自带一定滤镜、美颜效果，从而使先前设置的滤镜、美颜失效。关于细节，咨询技术支持人员。

• 由于 CV SDK 尚未兼顾与 Android 11+ 平台适配问题，有可能因与 API 30 不兼容而导致应用崩溃。此时，你需将 targetSdkVersion 版本降到 30 以下，或者关闭指针标记功能，参看已加标记的指针。

• 调用接口后可能产生的返回值有：

  • 0: 调用成功。
  • –1000: 未集成特效 SDK。
  • –1001: 特效 SDK 不支持该功能。
  • –1002: 特效 SDK 版本不兼容。
  • < 0: 调用失败，错误码对应具体描述参看错误码表。