LiteAVSDK
腾讯云音视频 SDK ，服务于数万家企业客户的高可用组件，致力于最大限度地节省您的研发成本。
TXBeautyManager

详细描述

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

结构体说明

◆ TXBeautyManager

class TXBeautyManager

构造函数

(void) - setBeautyStyle:
 
(void) - setBeautyLevel:
 
(void) - setWhitenessLevel:
 
(void) - enableSharpnessEnhancement:
 
(void) - setRuddyLevel:
 
(void) - setFilter:
 
(void) - setFilterStrength:
 
(int) - setGreenScreenFile:
 
(int) - setEyeScaleLevel:
 
(int) - setFaceSlimLevel:
 
(int) - setFaceVLevel:
 
(int) - setChinLevel:
 
(int) - setFaceShortLevel:
 
(int) - setFaceNarrowLevel:
 
(int) - setNoseSlimLevel:
 
(int) - setEyeLightenLevel:
 
(int) - setToothWhitenLevel:
 
(int) - setWrinkleRemoveLevel:
 
(int) - setPounchRemoveLevel:
 
(int) - setSmileLinesRemoveLevel:
 
(int) - setForeheadLevel:
 
(int) - setEyeDistanceLevel:
 
(int) - setEyeAngleLevel:
 
(int) - setMouthShapeLevel:
 
(int) - setNoseWingLevel:
 
(int) - setNosePositionLevel:
 
(int) - setLipsThicknessLevel:
 
(int) - setFaceBeautyLevel:
 
(void) - setMotionTmpl:inDir:
 
(void) - setMotionMute:
 

函数文档

◆ enableSharpnessEnhancement:()

- (void) enableSharpnessEnhancement: (BOOL)  enable

开启清晰度增强

◆ setBeautyLevel:()

- (void) setBeautyLevel: (float)  beautyLevel

设置美颜级别

参数
beautyLevel美颜级别，取值范围0 - 9； 0表示关闭，9表示效果最明显。

◆ setBeautyStyle:()

- (void) setBeautyStyle: (TXBeautyStyle)  beautyStyle

设置美颜（磨皮）算法

TRTC 内置多种不同的磨皮算法，您可以选择最适合您产品定位的方案：

参数
beautyStyle美颜风格，TXBeautyStyleSmooth：光滑；TXBeautyStyleNature：自然；TXBeautyStylePitu：优图。

◆ setChinLevel:()

- (int) setChinLevel: (float)  chinLevel

设置下巴拉伸或收缩，该接口仅在 企业版 SDK 中生效

参数
chinLevel下巴拉伸或收缩级别，取值范围-9 - 9；0 表示关闭，小于0表示收缩，大于0表示拉伸。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setEyeAngleLevel:()

- (int) setEyeAngleLevel: (float)  eyeAngleLevel

设置眼角调整级别，该接口仅在 企业版 SDK 中生效

参数
eyeAngleLevel眼角调整级别，取值范围-9 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setEyeDistanceLevel:()

- (int) setEyeDistanceLevel: (float)  eyeDistanceLevel

设置眼距，该接口仅在 企业版 SDK 中生效

参数
eyeDistanceLevel眼距级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setEyeLightenLevel:()

- (int) setEyeLightenLevel: (float)  eyeLightenLevel

设置亮眼级别，该接口仅在 企业版 SDK 中生效

参数
eyeLightenLevel亮眼级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setEyeScaleLevel:()

- (int) setEyeScaleLevel: (float)  eyeScaleLevel

设置大眼级别，该接口仅在 企业版 SDK 中生效

参数
eyeScaleLevel大眼级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setFaceBeautyLevel:()

- (int) setFaceBeautyLevel: (float)  faceBeautyLevel

设置脸型，该接口仅在 企业版 SDK 中生效

参数
faceBeautyLevel美型级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setFaceNarrowLevel:()

- (int) setFaceNarrowLevel: (float)  faceNarrowLevel

设置窄脸级别，该接口仅在 企业版 SDK 中生效

参数
level窄脸级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setFaceShortLevel:()

- (int) setFaceShortLevel: (float)  faceShortLevel

设置短脸级别，该接口仅在 企业版 SDK 中生效

参数
faceShortLevel短脸级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setFaceSlimLevel:()

- (int) setFaceSlimLevel: (float)  faceSlimLevel

设置瘦脸级别，该接口仅在 企业版 SDK 中生效

参数
faceSlimLevel瘦脸级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setFaceVLevel:()

- (int) setFaceVLevel: (float)  faceVLevel

设置 V 脸级别，该接口仅在 企业版 SDK 中生效

参数
faceVLevelV脸级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setFilter:()

- (void) setFilter: (nullable TXImage *)  image

设置色彩滤镜效果

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

参数
image包含色彩映射关系的颜色查找表图片，必须是 png 格式。

◆ setFilterStrength:()

- (void) setFilterStrength: (float)  strength

设置色彩滤镜的强度

该数值越高，色彩滤镜的作用强度越明显，经过滤镜处理后的视频画面跟原画面的颜色差异越大。 我默认的滤镜浓度是0.5，如果您觉得默认的滤镜效果不明显，可以设置为 0.5 以上的数字，最大值为1。

参数
strength从0到1，数值越大滤镜效果越明显，默认值为0.5。

◆ setForeheadLevel:()

- (int) setForeheadLevel: (float)  foreheadLevel

设置发际线调整级别，该接口仅在 企业版 SDK 中生效

参数
foreheadLevel发际线级别，取值范围-9 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setGreenScreenFile:()

- (int) setGreenScreenFile: (nullable NSString *)  path

设置绿幕背景视频，该接口仅在 企业版 SDK 中生效

此接口所开启的绿幕功能不具备智能去除背景的能力，需要被拍摄者的背后有一块绿色的幕布来辅助产生特效。

参数
pathMP4格式的视频文件路径; 设置空值表示关闭特效。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setLipsThicknessLevel:()

- (int) setLipsThicknessLevel: (float)  lipsThicknessLevel

设置嘴唇厚度，该接口仅在 企业版 SDK 中生效

参数
lipsThicknessLevel嘴唇厚度级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setMotionMute:()

- (void) setMotionMute: (BOOL)  motionMute

是否在动效素材播放时静音，该接口仅在 企业版 SDK 中生效 有些挂件本身会有声音特效，通过此 API 可以关闭这些特效播放时所带的声音效果。

参数
motionMuteYES：静音；NO：不静音。

◆ setMotionTmpl:inDir:()

- (void) setMotionTmpl: (nullable NSString *)  tmplName
inDir: (nullable NSString *)  tmplDir 

选择 AI 动效挂件，该接口仅在 企业版 SDK 中生效

参数
tmplName动效挂件名称
tmplDir动效素材文件所在目录

◆ setMouthShapeLevel:()

- (int) setMouthShapeLevel: (float)  mouthShapeLevel

设置嘴型调整级别，该接口仅在 企业版 SDK 中生效

参数
mouthShapeLevel嘴型级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setNosePositionLevel:()

- (int) setNosePositionLevel: (float)  nosePositionLevel

设置鼻子位置，该接口仅在 企业版 SDK 中生效

参数
nosePositionLevel鼻子位置级别，取值范围-9 - 9；0表示关闭，小于0表示抬高，大于0表示降低。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setNoseSlimLevel:()

- (int) setNoseSlimLevel: (float)  noseSlimLevel

设置瘦鼻级别，该接口仅在 企业版 SDK 中生效

参数
noseSlimLevel瘦鼻级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setNoseWingLevel:()

- (int) setNoseWingLevel: (float)  noseWingLevel

设置鼻翼调整级别，该接口仅在 企业版 SDK 中生效

参数
noseWingLevel鼻翼调整级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setPounchRemoveLevel:()

- (int) setPounchRemoveLevel: (float)  pounchRemoveLevel

设置祛眼袋级别，该接口仅在 企业版 SDK 中生效

参数
pounchRemoveLevel祛眼袋级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setRuddyLevel:()

- (void) setRuddyLevel: (float)  ruddyLevel

设置红润级别

参数
ruddyLevel红润级别，取值范围0 - 9；0表示关闭，9表示效果最明显。

◆ setSmileLinesRemoveLevel:()

- (int) setSmileLinesRemoveLevel: (float)  smileLinesRemoveLevel

设置法令纹去除级别，该接口仅在 企业版 SDK 中生效

参数
smileLinesRemoveLevel法令纹级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setToothWhitenLevel:()

- (int) setToothWhitenLevel: (float)  toothWhitenLevel

设置牙齿美白级别，该接口仅在 企业版 SDK 中生效

参数
toothWhitenLevel白牙级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

◆ setWhitenessLevel:()

- (void) setWhitenessLevel: (float)  whitenessLevel

设置美白级别

参数
whitenessLevel美白级别，取值范围0 - 9；0表示关闭，9表示效果最明显。

◆ setWrinkleRemoveLevel:()

- (int) setWrinkleRemoveLevel: (float)  wrinkleRemoveLevel

设置祛皱级别，该接口仅在 企业版 SDK 中生效

参数
wrinkleRemoveLevel祛皱级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
返回
0：成功；-5：当前 License 对应 feature 不支持。

枚举类型说明

◆ TXBeautyStyle

enum TXBeautyStyle : NSInteger

美颜（磨皮）算法 TRTC 内置多种不同的磨皮算法，您可以选择最适合您产品定位的方案。

枚举值
TXBeautyStyleSmooth 

光滑，算法比较激进，磨皮效果比较明显，适用于秀场直播。

TXBeautyStyleNature 

自然，算法更多地保留了面部细节，磨皮效果更加自然，适用于绝大多数直播场景。

TXBeautyStylePitu 

优图，由优图实验室提供，磨皮效果介于光滑和自然之间，比光滑保留更多皮肤细节，比自然磨皮程度更高。