You need to enable JavaScript to run this app.
导航
Electron 基础美颜
最近更新时间:2023.12.14 14:20:14首次发布时间:2023.09.01 18:15:48

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

  • 基础美颜提供美白、锐化、磨皮效果,广泛适用于视频通话、直播等场景。
  • 智能美化特效特效提供美颜、滤镜、背景贴纸等高级特效,需付费使用。参看 RTC 和智能美化特效(CV)产品深度融合打造的智能美化特效功能。

功能变更日志

自 Electron SDK 3.44 起,基础美颜功能可用。

前提条件

  • 你已经集成了 RTC SDK,并实现音视频通话功能。

  • 操作系统需满足以下要求:

    • macOS: macOS 10.11+

    • Windows: Win 7+

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

操作步骤

步骤一:集成美颜模块

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

    • Windows:VolcEngineRTC/bin/Win32(x64)/effect.dll,pthreadVC2.dll
    • macOS:libeffect.dylib
  2. 更新打包配置,把美颜所需的动态库复制到指定目录。
    以 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 rtcVideo= new veRTCVideo();
rtcVideo.startVideoCapture();

步骤四:开启美颜

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

首次安装 App 时,调用 enableEffectBeauty 会返回 -1004,这表明当前正在下载美颜所需文件,下载完成后美颜会自动生效。文件下载成功后,后续开启基础美颜将立即生效,接口返回 0,此时可在本地预览画面中看到效果。
若未在开启前设置基础美颜强度,则美白、锐化、磨皮的默认强度为 0.5。

let ret = rtcVideo.enableEffectBeauty(true);

步骤五:设置美颜强度

调用 setBeautyIntensity 调整基础美颜强度。 若在开启基础美颜前设置调用,则对应美颜功能的强度初始值会根据设置更新。 销毁引擎后,强度设置将会失效,再次开启美颜时强度恢复默认值。
基础美颜的有效强度范围为 [0, 1],超过此范围则不生效。强度设置为 0 时无效果。

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

步骤六:关闭美颜

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