txbeautymanager

最近更新时间:2026-03-20 14:38:02

我的收藏
Copyright (c) 2021 Tencent. All rights reserved.

Module: 美颜与图像处理参数设置类

Function: 修改美颜、滤镜、绿幕等参数

txbeautymanager

TXBeautyManager

函数列表
描述
设置美颜(磨皮)算法。
设置美颜级别。
设置美白级别。
设置红润级别。
设置色彩滤镜效果。
设置色彩滤镜的强度。

枚举类型

枚举类型
描述
美颜(磨皮)算法。

setBeautyStyle

setBeautyStyle
setBeautyStyle
(beautyStyle: TXBeautyStyle)

设置美颜(磨皮)算法。

TRTC 内置多种不同的磨皮算法,您可以选择最适合您产品定位的方案:
参数
描述
beautyStyle
美颜风格,TXBeautyStyleSmooth:光滑;TXBeautyStyleNature:自然;TXBeautyStylePitu:优图。

setBeautyLevel

setBeautyLevel
setBeautyLevel
(beautyLevel: number)

设置美颜级别。

参数
描述
beautyLevel
美颜级别,取值范围 [0, 9]; 0 表示关闭,9 表示效果最明显。

setWhitenessLevel

setWhitenessLevel
setWhitenessLevel
(whitenessLevel: number)

设置美白级别。

参数
描述
whitenessLevel
美白级别,取值范围 [0, 9];0 表示关闭,9 表示效果最明显。

setRuddyLevel

setRuddyLevel
setRuddyLevel
(ruddyLevel: number)

设置红润级别。

参数
描述
ruddyLevel
红润级别,取值范围 [0, 9];0 表示关闭,9 表示效果最明显。

setFilter

setFilter
setFilter
(image: image.PixelMap|null)

设置色彩滤镜效果。

色彩滤镜,是一张包含色彩映射关系的颜色查找表图片,您可以在我们提供的官方 Demo 中找到预先准备好的几张滤镜图片。
SDK 会根据该查找表中的映射关系,对摄像头采集出的原始视频画面进行二次处理,以达到预期的滤镜效果。
参数
描述
image
包含色彩映射关系的颜色查找表图片,必须是 png 格式。

setFilterStrength

setFilterStrength
setFilterStrength
(strength: number)

设置色彩滤镜的强度。

该数值越高,色彩滤镜的作用强度越明显,经过滤镜处理后的视频画面跟原画面的颜色差异越大。
默认的滤镜浓度为 0.5,如果您觉得默认的滤镜效果不明显,可以设置为 0.5 以上的数字,最大值为 1。
参数
描述
strength
取值范围 [0, 1],数值越大滤镜效果越明显,默认值为 0.5。

TXBeautyStyle

TXBeautyStyle

美颜(磨皮)算法。

TRTC 内置多种不同的磨皮算法,您可以选择最适合您产品定位的方案。
枚举
取值
描述
TXBeautyStyleSmooth
0
光滑,算法比较激进,磨皮效果比较明显,适用于秀场直播。
TXBeautyStyleNature
1
自然,算法更多地保留了面部细节,磨皮效果更加自然,适用于绝大多数直播场景。
TXBeautyStylePitu
2
优图,由优图实验室提供,磨皮效果介于光滑和自然之间,比光滑保留更多皮肤细节,比自然磨皮程度更高。