RTC 提供基础美颜插件,你可以通过此插件实现美白、磨皮、锐化等基础美颜功能。
RTC SDK 4.47+ 你需要集成 RTC SDK,并实现音视频通话功能。
美颜插件支持如下浏览器:
Chrome 94+
Edge 94+
Opera 80+
为了更好的使用体验,建议设备满足以下要求:
双核 Intel Core i5+
RAM 8 GB+
64 位操作系统
import RTCBeautyExtension from '@volcengine/rtc/extension-beauty';
typescriptimport VERTC from '@volcengine/rtc';
// 创建引擎实例
const engine = VERTC.createEngine('appid');
// 创建美颜插件实例
const beautyExtension = new RTCBeautyExtension();
// 注册美颜插件
try {
await engine.registerExtension(beautyExtension);
} catch (error) {
// 注册失败,详细信息:error.message
}
typescript注意
基础美颜仅对主流、本地流生效,不支持屏幕流、远端流。即 StreamIndex 必须为 STREAM_INDEX_MAIN。
// 开启内部视频采集
engine.startVideoCapture();
// 设置本地视频渲染时使用的视图,并设置渲染模式。
engine.setLocalVideoPlayer(StreamIndex.STREAM_INDEX_MAIN, {
renderDom: 'yourDomId'
});
typescriptimport { EffectBeautyMode } from '@volcengine/rtc/extension-beauty';
// 美颜参数设置-美白
beautyExtension.setBeautyIntensity(EffectBeautyMode.EFFECT_WHITE_MODE, 0.2);
// 美颜参数设置-磨皮
beautyExtension.setBeautyIntensity(EffectBeautyMode.EFFECT_SMOOTH_MODE, 0.2);
// 美颜参数设置-锐化
beautyExtension.setBeautyIntensity(EffectBeautyMode.EFFECT_SHARPEN_MODE, 0.2);
typescript说明
如调用本方法前未调用 setBeautyIntensity 设置参数,则基础美颜强度使用默认值。
// 开启美颜
beautyExtension.enable();
typescript说明
若关闭基础美颜后再次调用 enable 开启基础美颜,则保留上次的美颜强度设置。若销毁引擎,则美颜强度恢复为默认值。
// 关闭美颜
beautyExtension.disable();
typescript类型: class
API
| 名称 | 描述 |
|---|---|
| enable | 开启基础美颜。 |
| disable | 关闭基础美颜。 |
| setBeautyIntensity | 设置基础美颜强度。 |
开启基础美颜。
类型
() => void
ts注意
关闭基础美颜。
类型
() => void
ts设置基础美颜强度。
类型
(beautyMode: EffectBeautyMode, intensity: number) => void
ts注意
参数
beautyMode
类型: EffectBeautyMode
基础美颜模式。
intensity
类型: number
美颜强度,取值范围为 [0,1]。强度为 0 表示关闭,默认强度为 0.5。
类型: enum
基础美颜模式。
成员
| 属性 | 值 | 描述 |
|---|---|---|
| EFFECT_WHITE_MODE | 0 | 美白。 |
| EFFECT_SMOOTH_MODE | 1 | 磨皮。 |
| EFFECT_SHARPEN_MODE | 2 | 锐化。 |