在社交娱乐或教育场景中,用户进行视频通话或直播时,常常希望向对方呈现良好的肌肤状态和精神面貌。声网 SDK 提供 API 方法,帮助开发者轻松实现基础美颜功能。用户可以开启美颜开关,调整美白、磨皮、祛痘、红润效果等美颜参数,实现自然的美颜效果。
具体效果可参考下图:
在实现美颜功能前,请确保已在你的项目中实现基本的实时音视频功能。详见开始音视频通话或开始互动直播。
调用 setBeautyEffectOptions
方法设置基础美颜功能。该 API 为异步方法,需使用 Promise 或 async/await 关键字进行调用。
Client.on("stream-published")
回调中调用本方法。 该方法有两个参数:
enabled
代表是否开启美颜功能。options
代表美颜选项,包含 lighteningContrastLevel
(明暗对比度)、lighteningLevel
(亮度)、smoothnessLevel
(平滑度)、rednessLevel
(红色度)四个参数,可用来实现美白、磨皮、红润等效果。var streamPublishedHandler = async function() {
await localStream.setBeautyEffectOptions(true, {
lighteningContrastLevel: 1,
lighteningLevel: 0.7,
smoothnessLevel: 0.5,
rednessLevel: 0.1
});
client.off("stream-published", streamPublishedHandler);
}
client.on("stream-published", streamPublishedHandler);
replaceTrack
或 addTrack
创建的视频流开启美颜,必须在 replaceTrack
或 addTrack
完成之后调用 setBeautyEffectOptions
。stream.setBeautyEffectOptions(false)
关闭美颜功能。leave
stop
replaceTrack
removeTrack
unpublish