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

详细描述

美颜及动效参数管理


结构体说明

◆ TXBeautyManager

class TXBeautyManager

构造函数

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

函数文档

◆ setBeautyStyle()

- (void) setBeautyStyle: (TXBeautyStyle beautyStyle

设置美颜(磨皮)算法

SDK 内部集成了两套风格不同的磨皮算法,一套我们取名叫“光滑”,适用于美女秀场,效果比较明显。 另一套我们取名“自然”,磨皮算法更多地保留了面部细节,主观感受上会更加自然。

参数
beautyStyle美颜风格,光滑或者自然,光滑风格磨皮更加明显,适合娱乐场景。

◆ setBeautyLevel()

- (void) setBeautyLevel: (float)  level

设置美颜级别

参数
level美颜级别,取值范围0 - 9; 0表示关闭,1 - 9值越大,效果越明显。

◆ setWhitenessLevel()

- (void) setWhitenessLevel: (float)  level

设置美白级别

参数
level美白级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ enableSharpnessEnhancement()

- (void) enableSharpnessEnhancement: (BOOL)  enable

开启清晰度增强

参数
enableYES:开启清晰度增强;NO:关闭清晰度增强。默认值:YES

◆ setRuddyLevel()

- (void) setRuddyLevel: (float)  level

设置红润级别

参数
level红润级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setFilter()

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

设置指定素材滤镜特效

参数
image指定素材,即颜色查找表图片。**必须使用 png 格式**

◆ setFilterStrength()

- (void) setFilterStrength: (float)  strength

设置滤镜浓度

在美女秀场等应用场景里,滤镜浓度的要求会比较高,以便更加突显主播的差异。 我们默认的滤镜浓度是0.5,如果您觉得滤镜效果不明显,可以使用下面的接口进行调节。

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

◆ setGreenScreenFile()

- (void) setGreenScreenFile: (nullable NSString *)  file

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

此处的绿幕功能并非智能抠背,需要被拍摄者的背后有一块绿色的幕布来辅助产生特效

参数
file视频文件路径。支持 MP4; nil 表示关闭特效。

◆ setEyeScaleLevel()

- (void) setEyeScaleLevel: (float)  level

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

参数
level大眼级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setFaceSlimLevel()

- (void) setFaceSlimLevel: (float)  level

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

参数
level瘦脸级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setFaceVLevel()

- (void) setFaceVLevel: (float)  level

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

参数
levelV脸级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setChinLevel()

- (void) setChinLevel: (float)  level

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

参数
level下巴拉伸或收缩级别,取值范围-9 - 9;0 表示关闭,小于0表示收缩,大于0表示拉伸。

◆ setFaceShortLevel()

- (void) setFaceShortLevel: (float)  level

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

参数
level短脸级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setNoseSlimLevel()

- (void) setNoseSlimLevel: (float)  level

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

参数
level瘦鼻级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setEyeLightenLevel()

- (void) setEyeLightenLevel: (float)  level

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

参数
level亮眼级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setToothWhitenLevel()

- (void) setToothWhitenLevel: (float)  level

设置白牙 ,该接口仅在 企业版 SDK 中生效

参数
level白牙级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setWrinkleRemoveLevel()

- (void) setWrinkleRemoveLevel: (float)  level

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

参数
level祛皱级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setPounchRemoveLevel()

- (void) setPounchRemoveLevel: (float)  level

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

参数
level祛眼袋级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setSmileLinesRemoveLevel()

- (void) setSmileLinesRemoveLevel: (float)  level

设置法令纹 ,该接口仅在 企业版 SDK 中生效

参数
level法令纹级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setForeheadLevel()

- (void) setForeheadLevel: (float)  level

设置发际线 ,该接口仅在 企业版 SDK 中生效

参数
level发际线级别,取值范围-9 - 9;0表示关闭,小于0表示抬高,大于0表示降低。

◆ setEyeDistanceLevel()

- (void) setEyeDistanceLevel: (float)  level

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

参数
level眼距级别,取值范围-9 - 9;0表示关闭,小于0表示拉伸,大于0表示收缩。

◆ setEyeAngleLevel()

- (void) setEyeAngleLevel: (float)  level

设置眼角 ,该接口仅在 企业版 SDK 中生效

参数
level眼角级别,取值范围-9 - 9;0表示关闭,小于0表示降低,大于0表示抬高。

◆ setMouthShapeLevel()

- (void) setMouthShapeLevel: (float)  level

设置嘴型 ,该接口仅在 企业版 SDK 中生效

参数
level嘴型级别,取值范围-9 - 9;0表示关闭,小于0表示拉伸,大于0表示收缩。

◆ setNoseWingLevel()

- (void) setNoseWingLevel: (float)  level

设置鼻翼 ,该接口仅在 企业版 SDK 中生效

参数
level鼻翼级别,取值范围-9 - 9;0表示关闭,小于0表示拉伸,大于0表示收缩。

◆ setNosePositionLevel()

- (void) setNosePositionLevel: (float)  level

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

参数
level鼻子位置级别,取值范围-9 - 9;0表示关闭,小于0表示抬高,大于0表示降低。

◆ setLipsThicknessLevel()

- (void) setLipsThicknessLevel: (float)  level

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

参数
level嘴唇厚度级别,取值范围-9 - 9;0表示关闭,小于0表示拉伸,大于0表示收缩。

◆ setFaceBeautyLevel()

- (void) setFaceBeautyLevel: (float)  level

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

参数
level美型级别,取值范围0 - 9;0表示关闭,1 - 9值越大,效果越明显。

◆ setMotionTmpl()

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

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

参数
tmplName动效名称
tmplDir动效所在目录

◆ setMotionMute()

- (void) setMotionMute: (BOOL)  motionMute

设置动效静音,该接口仅在 企业版 SDK 中生效

有些挂件本身会有声音特效,通过此 API 可以关闭这些特效播放时所带的声音效果。

参数
motionMuteYES:静音;NO:不静音。

枚举类型说明

◆ TXBeautyStyle

enum TXBeautyStyle : NSInteger

美颜(磨皮)算法 SDK 内置了多种不同的磨皮算法,您可以选择最适合您产品定位的方案。

枚举值
TXBeautyStyleSmooth 

光滑,适用于美女秀场,效果比较明显。

TXBeautyStyleNature 

自然,磨皮算法更多地保留了面部细节,主观感受上会更加自然。

TXBeautyStylePitu 

由上海优图实验室提供的美颜算法,磨皮效果介于光滑和自然之间,比光滑保留更多皮肤细节,比自然磨皮程度更高。