直播 SDK TXBeautyManager-客户端 API-文档中心-腾讯云

Copyright (c) 2021 Tencent. All rights reserved.
﻿
Module:   美颜与图像处理参数设置类
﻿
Function: 修改美颜、滤镜、绿幕等参数
﻿
TXBeautyManager
TXBeautyManager
函数列表
描述
setBeautyStyle:
设置美颜（磨皮）算法
setBeautyLevel:
设置美颜级别
setWhitenessLevel:
设置美白级别
enableSharpnessEnhancement:
开启清晰度增强
setRuddyLevel:
设置红润级别
setFilter:
设置色彩滤镜效果
setFilterStrength:
设置色彩滤镜的强度
setGreenScreenFile:
设置绿幕背景视频
setEyeScaleLevel:
设置大眼级别
setFaceSlimLevel:
设置瘦脸级别
setFaceVLevel:
设置 V 脸级别
setChinLevel:
设置下巴拉伸或收缩
setFaceShortLevel:
设置短脸级别
setFaceNarrowLevel:
设置窄脸级别
setNoseSlimLevel:
设置瘦鼻级别
setEyeLightenLevel:
设置亮眼级别
setToothWhitenLevel:
设置牙齿美白级别
setWrinkleRemoveLevel:
设置祛皱级别
setPounchRemoveLevel:
设置祛眼袋级别
setSmileLinesRemoveLevel:
设置法令纹去除级别
setForeheadLevel:
设置发际线调整级别
setEyeDistanceLevel:
设置眼距
setEyeAngleLevel:
设置眼角调整级别
setMouthShapeLevel:
设置嘴型调整级别
setNoseWingLevel:
设置鼻翼调整级别
setNosePositionLevel:
设置鼻子位置
setLipsThicknessLevel:
设置嘴唇厚度
setFaceBeautyLevel:
设置脸型
setMotionTmpl:inDir:
选择 AI 动效挂件
setMotionMute:
是否在动效素材播放时静音
枚举类型
枚举类型
描述
TXBeautyStyle
美颜（磨皮）算法
setBeautyStyle:
setBeautyStyle:
- (void)setBeautyStyle:
(﻿TXBeautyStyle﻿)beautyStyle
设置美颜（磨皮）算法TRTC 内置多种不同的磨皮算法，您可以选择最适合您产品定位的方案：
参数
描述
beautyStyle
美颜风格，TXBeautyStyleSmooth：光滑；TXBeautyStyleNature：自然；TXBeautyStylePitu：优图。
setBeautyLevel:
setBeautyLevel:
- (void)setBeautyLevel:
(float)beautyLevel
设置美颜级别参数
描述
beautyLevel
美颜级别，取值范围 0 - 9； 0 表示关闭，9 表示效果最明显。
setWhitenessLevel:
setWhitenessLevel:
- (void)setWhitenessLevel:
(float)whitenessLevel
设置美白级别参数
描述
whitenessLevel
美白级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。
enableSharpnessEnhancement:
enableSharpnessEnhancement:
- (void)enableSharpnessEnhancement:
(BOOL)enable
开启清晰度增强
setRuddyLevel:
setRuddyLevel:
- (void)setRuddyLevel:
(float)ruddyLevel
设置红润级别参数
描述
ruddyLevel
红润级别，取值范围0 - 9；0 表示关闭，9 表示效果最明显。
setFilter:
setFilter:
- (void)setFilter:
(nullable TXImage *)image
设置色彩滤镜效果色彩滤镜，是一副包含色彩映射关系的颜色查找表图片，您可以在我们提供的官方 Demo 中找到预先准备好的几张滤镜图片。
SDK 会根据该查找表中的映射关系，对摄像头采集出的原始视频画面进行二次处理，以达到预期的滤镜效果。
参数
描述
image
包含色彩映射关系的颜色查找表图片，必须是 png 格式。
setFilterStrength:
setFilterStrength:
- (void)setFilterStrength:
(float)strength
设置色彩滤镜的强度该数值越高，色彩滤镜的作用强度越明显，经过滤镜处理后的视频画面跟原画面的颜色差异越大。
我默认的滤镜浓度是 0.5，如果您觉得默认的滤镜效果不明显，可以设置为 0.5 以上的数字，最大值为 1。
参数
描述
strength
从 0 到 1，数值越大滤镜效果越明显，默认值为 0.5。
setGreenScreenFile:
setGreenScreenFile:
- (int)setGreenScreenFile:
(nullable NSString *)path
设置绿幕背景视频该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。此接口所开启的绿幕功能不具备智能去除背景的能力，需要被拍摄者的背后有一块绿色的幕布来辅助产生特效。
参数
描述
path
MP4格式的视频文件路径; 设置空值表示关闭特效。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setEyeScaleLevel:
setEyeScaleLevel:
- (int)setEyeScaleLevel:
(float)eyeScaleLevel
设置大眼级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
eyeScaleLevel
大眼级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setFaceSlimLevel:
setFaceSlimLevel:
- (int)setFaceSlimLevel:
(float)faceSlimLevel
设置瘦脸级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
faceSlimLevel
瘦脸级别，取值范围0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setFaceVLevel:
setFaceVLevel:
- (int)setFaceVLevel:
(float)faceVLevel
设置 V 脸级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
faceVLevel
V 脸级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setChinLevel:
setChinLevel:
- (int)setChinLevel:
(float)chinLevel
设置下巴拉伸或收缩该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
chinLevel
下巴拉伸或收缩级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示收缩，大于 0 表示拉伸。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setFaceShortLevel:
setFaceShortLevel:
- (int)setFaceShortLevel:
(float)faceShortLevel
设置短脸级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
faceShortLevel
短脸级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setFaceNarrowLevel:
setFaceNarrowLevel:
- (int)setFaceNarrowLevel:
(float)faceNarrowLevel
设置窄脸级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
level
窄脸级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setNoseSlimLevel:
setNoseSlimLevel:
- (int)setNoseSlimLevel:
(float)noseSlimLevel
设置瘦鼻级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
noseSlimLevel
瘦鼻级别，取值范围0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setEyeLightenLevel:
setEyeLightenLevel:
- (int)setEyeLightenLevel:
(float)eyeLightenLevel
设置亮眼级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
eyeLightenLevel
亮眼级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setToothWhitenLevel:
setToothWhitenLevel:
- (int)setToothWhitenLevel:
(float)toothWhitenLevel
设置牙齿美白级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
toothWhitenLevel
白牙级别，取值范围 0 - 9；0表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setWrinkleRemoveLevel:
setWrinkleRemoveLevel:
- (int)setWrinkleRemoveLevel:
(float)wrinkleRemoveLevel
设置祛皱级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
wrinkleRemoveLevel
祛皱级别，取值范围0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setPounchRemoveLevel:
setPounchRemoveLevel:
- (int)setPounchRemoveLevel:
(float)pounchRemoveLevel
设置祛眼袋级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
pounchRemoveLevel
祛眼袋级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setSmileLinesRemoveLevel:
setSmileLinesRemoveLevel:
- (int)setSmileLinesRemoveLevel:
(float)smileLinesRemoveLevel
设置法令纹去除级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
smileLinesRemoveLevel
法令纹级别，取值范围 0 - 9；0表示关闭，9 表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setForeheadLevel:
setForeheadLevel:
- (int)setForeheadLevel:
(float)foreheadLevel
设置发际线调整级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
foreheadLevel
发际线级别，取值范围-9 - 9；0表示关闭，9表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setEyeDistanceLevel:
setEyeDistanceLevel:
- (int)setEyeDistanceLevel:
(float)eyeDistanceLevel
设置眼距该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
eyeDistanceLevel
眼距级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示拉伸，大于 0 表示收缩。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setEyeAngleLevel:
setEyeAngleLevel:
- (int)setEyeAngleLevel:
(float)eyeAngleLevel
设置眼角调整级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
eyeAngleLevel
眼角调整级别，取值范围-9 - 9；0表示关闭，9表示效果最明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setMouthShapeLevel:
setMouthShapeLevel:
- (int)setMouthShapeLevel:
(float)mouthShapeLevel
设置嘴型调整级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
mouthShapeLevel
嘴型级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示拉伸，大于 0 表示收缩。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setNoseWingLevel:
setNoseWingLevel:
- (int)setNoseWingLevel:
(float)noseWingLevel
设置鼻翼调整级别该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
noseWingLevel
鼻翼调整级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示拉伸，大于 0 表示收缩。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setNosePositionLevel:
setNosePositionLevel:
- (int)setNosePositionLevel:
(float)nosePositionLevel
设置鼻子位置该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
nosePositionLevel
鼻子位置级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示抬高，大于 0 表示降低。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setLipsThicknessLevel:
setLipsThicknessLevel:
- (int)setLipsThicknessLevel:
(float)lipsThicknessLevel
设置嘴唇厚度该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
lipsThicknessLevel
嘴唇厚度级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示拉伸，大于 0 表示收缩。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setFaceBeautyLevel:
setFaceBeautyLevel:
- (int)setFaceBeautyLevel:
(float)faceBeautyLevel
设置脸型该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
faceBeautyLevel
美型级别，取值范围 0 - 9；0 表示关闭，1 - 9 值越大，效果越明显。
返回值说明：0：成功；-5：当前 License 对应 feature 不支持。
setMotionTmpl:inDir:
setMotionTmpl:inDir:
- (void)setMotionTmpl:
(nullable NSString *)tmplName
inDir:
(nullable NSString *)tmplDir
选择 AI 动效挂件该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
参数
描述
tmplDir
动效素材文件所在目录。
tmplName
动效挂件名称。
setMotionMute:
setMotionMute:
- (void)setMotionMute:
(BOOL)motionMute
是否在动效素材播放时静音该接口仅在 企业版 SDK（旧版已下线，新版本SDK如需使用高级美颜功能请参见﻿腾讯美颜特效SDK﻿）中生效。
有些挂件本身会有声音特效，通过此 API 可以关闭这些特效播放时所带的声音效果。
参数
描述
motionMute
YES：静音；NO：不静音。
TXBeautyStyle
TXBeautyStyle
美颜（磨皮）算法TRTC 内置多种不同的磨皮算法，您可以选择最适合您产品定位的方案。
枚举
取值
描述
TXBeautyStyleSmooth
0
光滑，算法比较激进，磨皮效果比较明显，适用于秀场直播。
TXBeautyStyleNature
1
自然，算法更多地保留了面部细节，磨皮效果更加自然，适用于绝大多数直播场景。
TXBeautyStylePitu
2
优图，由优图实验室提供，磨皮效果介于光滑和自然之间，比光滑保留更多皮肤细节，比自然磨皮程度更高。

函数列表	描述
setBeautyStyle:	设置美颜（磨皮）算法
setBeautyLevel:	设置美颜级别
setWhitenessLevel:	设置美白级别
enableSharpnessEnhancement:	开启清晰度增强
setRuddyLevel:	设置红润级别
setFilter:	设置色彩滤镜效果
setFilterStrength:	设置色彩滤镜的强度
setGreenScreenFile:	设置绿幕背景视频
setEyeScaleLevel:	设置大眼级别
setFaceSlimLevel:	设置瘦脸级别
setFaceVLevel:	设置 V 脸级别
setChinLevel:	设置下巴拉伸或收缩
setFaceShortLevel:	设置短脸级别
setFaceNarrowLevel:	设置窄脸级别
setNoseSlimLevel:	设置瘦鼻级别
setEyeLightenLevel:	设置亮眼级别
setToothWhitenLevel:	设置牙齿美白级别
setWrinkleRemoveLevel:	设置祛皱级别
setPounchRemoveLevel:	设置祛眼袋级别
setSmileLinesRemoveLevel:	设置法令纹去除级别
setForeheadLevel:	设置发际线调整级别
setEyeDistanceLevel:	设置眼距
setEyeAngleLevel:	设置眼角调整级别
setMouthShapeLevel:	设置嘴型调整级别
setNoseWingLevel:	设置鼻翼调整级别
setNosePositionLevel:	设置鼻子位置
setLipsThicknessLevel:	设置嘴唇厚度
setFaceBeautyLevel:	设置脸型
setMotionTmpl:inDir:	选择 AI 动效挂件
setMotionMute:	是否在动效素材播放时静音

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

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

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

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

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

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

参数	描述
path	MP4格式的视频文件路径; 设置空值表示关闭特效。

参数	描述
eyeScaleLevel	大眼级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。

参数	描述
faceSlimLevel	瘦脸级别，取值范围0 - 9；0 表示关闭，9 表示效果最明显。

参数	描述
faceVLevel	V 脸级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。

参数	描述
chinLevel	下巴拉伸或收缩级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示收缩，大于 0 表示拉伸。

参数	描述
faceShortLevel	短脸级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。

参数	描述
level	窄脸级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。

参数	描述
noseSlimLevel	瘦鼻级别，取值范围0 - 9；0 表示关闭，9 表示效果最明显。

参数	描述
eyeLightenLevel	亮眼级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。

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

参数	描述
wrinkleRemoveLevel	祛皱级别，取值范围0 - 9；0 表示关闭，9 表示效果最明显。

参数	描述
pounchRemoveLevel	祛眼袋级别，取值范围 0 - 9；0 表示关闭，9 表示效果最明显。

参数	描述
smileLinesRemoveLevel	法令纹级别，取值范围 0 - 9；0表示关闭，9 表示效果最明显。

TXBeautyManager

本页目录：

TXBeautyManager

枚举类型

setBeautyStyle:

设置美颜（磨皮）算法

setBeautyLevel:

设置美颜级别

setWhitenessLevel:

设置美白级别

enableSharpnessEnhancement:

开启清晰度增强

setRuddyLevel:

设置红润级别

setFilter:

设置色彩滤镜效果

setFilterStrength:

设置色彩滤镜的强度

setGreenScreenFile:

设置绿幕背景视频

返回值说明：

setEyeScaleLevel:

设置大眼级别

返回值说明：

setFaceSlimLevel:

设置瘦脸级别

返回值说明：

setFaceVLevel:

设置 V 脸级别

返回值说明：

setChinLevel:

设置下巴拉伸或收缩

返回值说明：

setFaceShortLevel:

设置短脸级别

返回值说明：

setFaceNarrowLevel:

设置窄脸级别

返回值说明：

setNoseSlimLevel:

设置瘦鼻级别

返回值说明：

setEyeLightenLevel:

设置亮眼级别

返回值说明：

setToothWhitenLevel:

设置牙齿美白级别

返回值说明：

setWrinkleRemoveLevel:

设置祛皱级别

返回值说明：

setPounchRemoveLevel:

设置祛眼袋级别

返回值说明：

setSmileLinesRemoveLevel:

设置法令纹去除级别

返回值说明：

setForeheadLevel:

设置发际线调整级别

返回值说明：

setEyeDistanceLevel:

设置眼距

返回值说明：

setEyeAngleLevel:

设置眼角调整级别

返回值说明：

setMouthShapeLevel:

设置嘴型调整级别

返回值说明：

setNoseWingLevel:

设置鼻翼调整级别

返回值说明：

setNosePositionLevel:

设置鼻子位置

返回值说明：

setLipsThicknessLevel:

设置嘴唇厚度

返回值说明：

setFaceBeautyLevel:

设置脸型

参数	描述
foreheadLevel	发际线级别，取值范围-9 - 9；0表示关闭，9表示效果最明显。

参数	描述
eyeDistanceLevel	眼距级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示拉伸，大于 0 表示收缩。

参数	描述
eyeAngleLevel	眼角调整级别，取值范围-9 - 9；0表示关闭，9表示效果最明显。

参数	描述
mouthShapeLevel	嘴型级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示拉伸，大于 0 表示收缩。

参数	描述
noseWingLevel	鼻翼调整级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示拉伸，大于 0 表示收缩。

参数	描述
nosePositionLevel	鼻子位置级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示抬高，大于 0 表示降低。

参数	描述
lipsThicknessLevel	嘴唇厚度级别，取值范围 -9 - 9；0 表示关闭，小于 0 表示拉伸，大于 0 表示收缩。

参数	描述
faceBeautyLevel	美型级别，取值范围 0 - 9；0 表示关闭，1 - 9 值越大，效果越明显。

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

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