文档中心

实时音视频

请输入

基础美颜（免费版）

Electron 基础美颜

RTC SDK 提供基础美颜和智能美化特效两种美颜功能，且二者不能共用。

基础美颜提供美白、锐化、磨皮效果，广泛适用于视频通话、直播等场景。

智能美化特效提供美颜、滤镜、背景贴纸等高级特效，需付费使用。参看 RTC 和智能美化特效（CV）产品深度融合打造的智能美化特效功能。

前提条件

你已经集成了 RTC Electron SDK 3.44 及以上版本，并实现音视频通话功能。

操作系统需满足以下要求：

macOS：macOS 10.11+

Windows：Win 7+

基础美颜首次运行时需要连接网络下载所需文件，因此需要确保你的设备具有网络连接，且系统时间正常。

操作步骤

步骤一：集成美颜模块

根据应用的目标平台，从相应的 RTC SDK 压缩包中获取动态库文件，复制到项目的根目录下。

Windows：VolcEngineRTC/bin/Win32(x64)/effect.dll，pthreadVC2.dll

macOS：libeffect.dylib

更新打包配置，把美颜所需的动态库复制到指定目录。

以 electron-builder 打包组件为例，在 extraResources 字段中指定需要打包的文件以及打包后的目标路径。

Windows：把动态库复制到主程序 exe 相同目录下。

macOS：把动态库复制到 Frameworks 目录下。

"build": {
"win": {
"extraResources": [
{
"from": "./effect.dll",
"to": "../effect.dll"
},
{
"from": "./pthreadVC2.dll",
"to": "../pthreadVC2.dll"
}
]
},
"mac": {
"extraResources": [
{
"from": "./libeffect.dylib",
"to": "../Frameworks/libeffect.dylib"
}
]
}
}

步骤二：添加素材资源

basic_beauty/​
  ComposeMakeup/​
    beauty_Android_lite/​
    ...​

步骤三：初始化

在创建引擎后，调用 startVideoCapture 开启视频采集。

const { RTCEngine } = require('@volcengine/vertc-electron-sdk');​
const rtcEngine = new RTCEngine();​
rtcEngine.createRTCEngine({ app_id: APP_ID, parameters: '' });​
rtcEngine.startVideoCapture();​

步骤四：开启美颜

调用 enableEffectBeauty，将参数 enable 设置为 true，开启基础美颜。

首次安装 App 时，调用 enableEffectBeauty 会返回 -1004，这表明当前正在下载美颜所需文件，下载完成后美颜会自动生效。文件下载成功后，后续开启基础美颜将立即生效，接口返回 0，此时可在本地预览画面中看到效果。

若未在开启前设置基础美颜强度，则美白、锐化、磨皮的默认强度为 0.5。

let ret = rtcEngine.enableEffectBeauty(true);

步骤五：设置美颜强度

调用 setBeautyIntensity 调整基础美颜强度。若在开启基础美颜前调用，则对应美颜功能会使用设置后的初始强度。销毁引擎后，强度设置失效，再次开启美颜时会恢复默认值。

基础美颜的有效强度范围为 [0, 1]，超过此范围则不生效。强度设置为 0 时无效果。

let ret = rtcEngine.setBeautyIntensity(EffectBeautyMode.kEffectBeautyWhite, 0.8);​

步骤六：关闭美颜

调用 enableEffectBeauty，将参数 enable 设置为 false，关闭基础美颜。

最近更新时间：2026.10.10 20:08:49

这个页面对您有帮助吗？

有用

无用