tencent cloud

文档反馈

TXBeautyManager

最后更新时间:2024-10-25 17:04:23
    Copyright (c) 2021 Tencent. All rights reserved.
    
    Module: 美颜与图像处理参数设置类
    
    Function: 修改美颜、滤镜、绿幕等参数
    
    TXBeautyManager

    TXBeautyManager

    函数列表
    描述
    设置美颜(磨皮)算法
    设置美颜级别
    设置美白级别
    开启清晰度增强
    设置红润级别
    设置色彩滤镜效果
    设置色彩滤镜的强度
    设置绿幕背景视频
    设置大眼级别
    设置瘦脸级别
    设置 V 脸级别
    设置下巴拉伸或收缩
    设置短脸级别
    设置窄脸级别
    设置瘦鼻级别
    设置亮眼级别
    设置牙齿美白级别
    设置祛皱级别
    设置祛眼袋级别
    设置法令纹去除级别
    设置发际线调整级别
    设置眼距
    设置眼角调整级别
    设置嘴型调整级别
    设置鼻翼调整级别
    设置鼻子位置
    设置嘴唇厚度
    设置脸型
    选择 AI 动效挂件
    是否在动效素材播放时静音

    枚举类型

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

    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
    优图,由优图实验室提供,磨皮效果介于光滑和自然之间,比光滑保留更多皮肤细节,比自然磨皮程度更高。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持