开启美颜

功能描述

TRTC 可以通过插件，帮助开发者轻松实现基础美颜功能。用户可以调整美颜参数，实现自然的美颜效果。 点击此处 体验效果。

注意事项

• 除了以上支持的平台，其他平台均不支持
• 美颜的计算和渲染都比较消耗性能，如果使用者的设备性能不足以支撑运算，建议不开启美颜功能。
  • 2.6 GHz 六核Intel Core i7 16G 内存处理器的设备性能数据：
    • 480p 15帧的视频，使用美颜处理时，占用 CPU 比正常音视频通话要多 10% 左右。

接入攻略

前提

如果您需要使用 RTCBeautyPlugin 的美颜能力时，请将 TRTC SDK 升级到 4.11.1 及以上版本。

在项目中安装 RTCBeautyPlugin 插件。

npm install rtc-beauty-plugin

Step1. 创建 RTCBeautyPlugin 实例

一个 RTCBeautyPlugin 实例只能用来处理一条本地音视频流。

const beautyPlugin = new RTCBeautyPlugin();

Step2. 使用 RTCBeautyPlugin 的实例处理需要发布的流

const beautyStream = beautyPlugin.generateBeautyStream(localStream);
// 发布经过美颜后的流
await client.publish(beautyStream);

API 说明

generateBeautyStream(localStream)

将 localStream 处理成经过美颜后的 beautyStream。

// 初始化美颜插件
const beautyPlugin = new RTCBeautyPlugin();
await localStream.initialize();
// 生成美颜处理后的流
const beautyStream = beautyPlugin.generateBeautyStream(localStream);
// 发布经过美颜后的流
await client.publish(beautyStream);

setBeautyParam(options)

功能： 调节美颜插件的美颜程度。

如果您想关闭美颜效果，将三个参数都设置为 0 即可。

Params:

beautyPlugin.setBeautyParam({ beauty: 0.5, brightness: 0.5, ruddy: 0.5 });
// 如果您想关闭美颜效果，将三个参数都设置为 0 即可，如果要重新开启，设置任意一个参数 > 0 即可打开美颜能力。
beautyPlugin.setBeautyParam({ beauty: 0, brightness: 0, ruddy: 0 });

destroy()

功能： 销毁美颜插件。

使用方式： 在推流结束之后，可以销毁美颜插件，避免内存占用和性能消耗。

await client.leave();
beautyPlugin.destroy();

常见问题

1. 一个 RTCBeautyPlugin 实例只能处理一条本地流。

2. 使用 replaceTrack 等操作会导致您的 localStream 美颜效果消失，请酌情使用。