帮你快速理解、总结文档立即下载

新手指引

最近更新时间:2026-08-27 10:31:30
我的收藏
美颜特效 SDK 可以让您在直播或短视频中快速实现美颜、滤镜、贴纸道具、背景分割等效果。我们为您提供了包含界面代码的 UI 组件,也提供了纯 SDK 形式的无 UI 集成方案,两种方案的差异参见 无 UI 和含 UI 集成方案区别。

使用美颜特效的流程

1. 体验效果

在 Demo 体验页面 下载对应平台的包,安装并进行体验。
根据体验的效果结合美颜 功能说明 选择适合您的套餐。

2. 申请 License 信息

由于美颜特效 SDK 需要鉴权操作,所以需要 申请 License 信息,项目中只有鉴权成功才能使用美颜功能。

3. 运行 Demo 工程

Demo 体验页面 提供了多种场景的 Demo 工程,可根据提示信息选择对应场景的 Demo。

4. 下载 SDK 并集成

在 SDK 下载 页面下载您套餐对应的 SDK,如果您在刚开始的时候还不清楚使用哪个套餐,那么您可以直接选择 S1-07的 SDK 进行下载,此 SDK 包含了美颜特效的所有功能,等您选定套餐之后就再进行替换。
您可根据您的业务场景,参考如下文档进行集成:
在 TRTC 中接入美颜特效可参见 TRTC SDK 集成美颜特效
在腾讯直播中接入美颜特效可参见 直播 SDK 集成美颜特效
在短视频中接入美颜特效可参见 短视频 SDK 集成美颜特效
其他厂商 RTC 或自采集相机中接入美颜特效可参见 通用集成美颜特效

5. 获取素材

根据您在第一步中的 Demo 体验,结合您套餐的 功能说明 选择对应功能所包含的素材(滤镜和贴纸),将素材名称发给美颜特效的 工作人员,工作人员将根据您的选择提供对应的素材。
注意:
SDK 中的贴纸和 Demo 工程中的贴纸只用于测试。如需更多素材,可在购买套餐后进入 素材商城 进行挑选。

常见问题排查

集成问题参见 SDK 集成问题排查
性能问题参见 性能问题排查
效果问题参见 效果问题排查

无 UI 和含 UI 集成方案的区别

含 UI 集成是指在原始 SDK 的基础上提供了一套默认的美颜面板 UI,减少 UI 开发的成本,提升美颜特效的集成速度。
含 UI 美颜面板效果如下:



无 UI 集成是指使用美颜特效的原始 SDK 进行集成,需要自行处理美颜面板 UI 的开发和美颜属性的管理,适合对美颜面板有特殊要求的需求。