AI 美颜
当前页

Class

ZegoEffectsZegoEffectsAdvancedConfig
ZegoEffectsBigEyesParamZegoEffectsBlurParam
ZegoEffectsBlusherParamZegoEffectsCheekboneSlimmingParam
ZegoEffectsCheekParamZegoEffectsChromaKeyParam
ZegoEffectsColoredcontactsParamZegoEffectsDarkCirclesRemovingParam
ZegoEffectsEyelashesParamZegoEffectsEyelinerParam
ZegoEffectsEyesBrighteningParamZegoEffectsEyeshadowParam
ZegoEffectsFaceDetectionResultZegoEffectsFaceLiftingParam
ZegoEffectsFaceShorteningParamZegoEffectsFilterParam
ZegoEffectsForeheadShorteningParamZegoEffectsLipstickParam
ZegoEffectsLongChinParamZegoEffectsMakeupParam
ZegoEffectsMandibleSlimmingParamZegoEffectsMosaicParam
ZegoEffectsNoseLengtheningParamZegoEffectsNoseNarrowingParam
ZegoEffectsRosyParamZegoEffectsSharpenParam
ZegoEffectsSmallMouthParamZegoEffectsSmoothParam
ZegoEffectsTeethWhiteningParamZegoEffectsVideoFrameParam
ZegoEffectsWhitenParamZegoEffectsWrinklesRemovingParam

ZegoEffects

AI 美颜相关接口

详情

AI 美颜相关接口

方法

getAuthInfo

static
getAuthInfo
getAuthInfo(info: char** , appSign: string, context: Context): string
获取 SDK 授权信息,通过授权信息和 appID 可以向 ZEGO 服务器申请鉴权文件。

参数

名称类型描述
infochar**授权信息。
appSignstring每个 AppID 对应的应用签名。该参数为包含 64 个字符的字符串,字符取值范围:'0' ~ '9', 'a' ~ 'z'。例:"9dc9a25bh2f2137446897071c8c033fa33b91c3dd2a85e0c000ae82c0dad3"。
contextContext上下文。

详情

获取 SDK 授权信息,通过授权信息和 appID 可以向 ZEGO 服务器申请鉴权文件。

返回值

授权信息。

getVersion

static
getVersion
getVersion(): string
获取 Effects 版本号。

SDK 在运行过程中,当开发者发现与预期情况不符时,可将问题与相关日志提交给 ZEGO 技术人员定位,ZEGO 技术人员可能需要 SDK 的版本的信息来辅助定位问题。 开发者也可以收集此信息作为 App 所使用的 SDK 的版本信息,以便统计线上各版本 App 对应的各版本 SDK。

SDK 版本号。

setAdvancedConfig

static
setAdvancedConfig
setAdvancedConfig(config: ZegoEffectsAdvancedConfig): void
Effects 高级功能开关。

参数

名称类型描述
configZegoEffectsAdvancedConfigeffects 高级配置。如渲染模式、设备性能等级等等
  • 调用时机:初始化 SDK 之前。

setResources

static
setResources
setResources(resourceInfoList: string[]): void
设置 Effects 静态资源。

参数

名称类型描述
resourceInfoListstring[]资源列表。

详情

在调用 [enableWhiten] [enableTeethWhitening] [setPendant] 接口时,需要调用此函数设置静态资源。 支持同时设置多个资源路径。 注意:必须在创建 Effects 实例前设置。

create

static
create
create(license: string, context: Context): ZegoEffects
创建 Effects 实例。

参数

名称类型描述
licensestring鉴权证书文件。
contextContext上下文。

详情

在调用其他函数前需要先创建并初始化 Effects 实例;SDK 支持创建多个 ZegoEffects 实例。

返回值

ZegoEffects实例对象。

enableAcneRemoving

enableAcneRemoving
enableAcneRemoving(enable: boolean): ZegoEffects
开启祛痘斑功能,可调用 [setAcneRemovingParam] 接口设置祛痘斑参数。

参数

名称类型描述
enableboolean是否启动祛痘斑功能;[true] 表示启动该功能,[false] 表示关闭该功能。默认值为 [false]。

详情

开启祛痘斑功能,可调用 [setAcneRemovingParam] 接口设置祛痘斑参数。

enableCheekboneSlimming

enableCheekboneSlimming
enableCheekboneSlimming(enable: boolean): ZegoEffects
开启瘦颧骨功能,可调用 [setCheekboneSlimmingParam] 接口设置瘦颧骨参数。

参数

名称类型描述
enableboolean是否启动瘦颧骨功能;[true] 表示启动瘦颧骨功能;[false] 表示关闭瘦颧骨功能。默认值为 [false]。

详情

开启瘦颧骨功能,可调用 [setCheekboneSlimmingParam] 接口设置瘦颧骨参数。

enableClarity

enableClarity
enableClarity(enable: boolean): ZegoEffects
开启清晰功能,可调用 [setClarityParam] 接口设置清晰参数。

参数

名称类型描述
enableboolean是否启动清晰功能;[true] 表示启动该功能,[false] 表示关闭该功能。默认值为 [false]。

详情

开启清晰功能,可调用 [setClarityParam] 接口设置清晰参数。

enableDarkCirclesRemoving

enableDarkCirclesRemoving
enableDarkCirclesRemoving(enable: boolean): ZegoEffects
开启黑眼圈去除功能,可调用 [setDarkCirclesRemovingParam] 接口设置黑眼圈去除参数。

参数

名称类型描述
enableboolean是否启动去除黑眼圈功能;[true] 表示启动去除黑眼圈功能;[false] 表示关闭去除黑眼圈功能。默认值为 [false]。

详情

开启黑眼圈去除功能,可调用 [setDarkCirclesRemovingParam] 接口设置黑眼圈去除参数。

enableFaceShortening

enableFaceShortening
enableFaceShortening(enable: boolean): ZegoEffects
开启小脸功能,可调用 [setFaceShorteningParam] 接口设置小脸参数。

参数

名称类型描述
enableboolean是否启动小脸功能;[true] 表示启动小脸功能;[false] 表示关闭小脸功能。默认值为 [false]。

详情

开启小脸功能,可调用 [setFaceShorteningParam] 接口设置小脸参数。

enableForeheadShortening

enableForeheadShortening
enableForeheadShortening(enable: boolean): ZegoEffects
开启缩小额头高度功能,可调用 [setForeheadShorteningParam] 接口设置缩小额头高度参数。

参数

名称类型描述
enableboolean是否启动缩小额头高度功能;[true] 表示启动缩小额头高度功能;[false] 表示关闭缩小额头高度功能。默认值为 [false]。

详情

开启缩小额头高度功能,可调用 [setForeheadShorteningParam] 接口设置缩小额头高度参数。

返回值

ZegoEffects

enableImageProcessing

enableImageProcessing
enableImageProcessing(enable: boolean): void
当前Effects对象绑定/解绑到Express 的自定义渲染流程.

参数

名称类型描述
enablebooleantrue : 把自身Effects对象绑定到Express自定义渲染流程 . false: 把自身Effects对象解绑到Express自定义渲染流程.

详情

把当前Effects对象绑定到Express 的自定义渲染流程.

  • 业务场景:描述该方法/函数在什么场景下使用,若场景太多可以重点体现典型场景。
  • 调用时机/通知时机:创建Effects对象以后调用该函数。
  • 支持版本:v1.0.0

enableMandibleSlimming

enableMandibleSlimming
enableMandibleSlimming(enable: boolean): ZegoEffects
开启瘦下颌骨功能,可调用 [setMandibleSlimmingParam] 接口设置瘦下颌骨参数。

参数

名称类型描述
enableboolean是否启动瘦下颌骨功能;[true] 表示启动瘦下颌骨功能;[false] 表示关闭瘦下颌骨功能。默认值为 [false]。

详情

开启瘦下颌骨功能,可调用 [setMandibleSlimmingParam] 接口设置瘦下颌骨参数。

enableNoseLengthening

enableNoseLengthening
enableNoseLengthening(enable: boolean): ZegoEffects
开启长鼻功能,可调用 [setNoseLengtheningParam] 接口设置长鼻参数。

参数

名称类型描述
enableboolean是否启动长鼻功能;[true] 表示启动长鼻功能;[false] 表示关闭长鼻功能。默认值为 [false]。

详情

开启长鼻功能,可调用 [setNoseLengtheningParam] 接口设置长鼻参数。

返回值

ZegoEffects

enableSkinColor

enableSkinColor
enableSkinColor(enable: boolean): ZegoEffects
开启换肤功能

参数

名称类型描述
enableboolean是否启动换肤功能;[true] 表示启动该功能,[false] 表示关闭该功能。默认值为 [false]。

详情

开启换肤功能,可调用 [setSkinColorParam] 接口设置其参数,以及[setSkinColorResPath]接口设置对应的肤色风格。

enableWrinklesRemoving

enableWrinklesRemoving
enableWrinklesRemoving(enable: boolean): ZegoEffects
开启法令纹去除功能,可调用 [setWrinklesRemovingParam] 接口设置法令纹去除参数。

参数

名称类型描述
enableboolean是否启动去法令纹功能;[true] 表示启动去法令纹功能;[false] 表示关闭去法令纹功能。默认值为 [false]。

详情

开启法令纹去除功能,可调用 [setWrinklesRemovingParam] 接口设置法令纹去除参数。

getDeviceLevel

getDeviceLevel
getDeviceLevel(): ZegoEffectsDeviceLevel
获取设备手机性能等级。在Effects环境初始化之前部署来获取对应设备性能的效果能力。

SDK 在运行过程中,当开发者发现与预期情况不符时,可将问题与相关日志提交给 ZEGO 技术人员定位,ZEGO 技术人员可能需要 SDK 的设备性能等级来辅助定位问题。

设备性能等级枚举,对应整型序号

setAcneRemovingParam

setAcneRemovingParam
setAcneRemovingParam(param: ZegoEffectsAcneRemovingParam): ZegoEffects
设置祛痘斑参数。

参数

名称类型描述
paramZegoEffectsAcneRemovingParam祛痘斑功能参数。

详情

设置祛痘斑参数。

setBlusher

setBlusher
setBlusher(path?: string): ZegoEffects
设置腮红资源,设置 [null] 默认去除腮红效果。

参数

名称类型描述
pathstring腮红资源的绝对路径。

详情

开发者可调用 [setBlusherParam] 进行设置腮红参数,当设置对应腮红资源时,会自动启动腮红功能。

  • 支持版本:1.4.0。

setBlusherParam

setBlusherParam
setBlusherParam(param: ZegoEffectsBlusherParam): ZegoEffects
设置腮红参数。

参数

名称类型描述
paramZegoEffectsBlusherParam腮红参数。

详情

设置腮红参数。

setCheekboneSlimmingParam

setCheekboneSlimmingParam
setCheekboneSlimmingParam(param: ZegoEffectsCheekboneSlimmingParam): ZegoEffects
设置瘦颧骨参数。

参数

名称类型描述
paramZegoEffectsCheekboneSlimmingParam瘦颧骨功能参数。

详情

设置瘦颧骨参数。

setClarityParam

setClarityParam
setClarityParam(param: ZegoEffectsClarityParam): ZegoEffects
设置清晰参数。

参数

名称类型描述
paramZegoEffectsClarityParam清晰功能参数。

详情

设置清晰参数。

setColoredcontacts

setColoredcontacts
setColoredcontacts(path?: string): void
设置美瞳资源,设置 [null] 默认去除美瞳效果。

参数

名称类型描述
pathstring美瞳资源的绝对路径。

详情

开发者可调用 [setColoredcontactsParam] 进行设置美瞳参数,当设置对应美瞳资源时,会自动启动美妆美瞳功能。

  • 支持版本:1.4.0。

setColoredcontactsParam

setColoredcontactsParam
setColoredcontactsParam(param: ZegoEffectsColoredcontactsParam): ZegoEffects
设置美瞳参数。

参数

名称类型描述
paramZegoEffectsColoredcontactsParam美瞳参数。

详情

设置美瞳参数。

setDarkCirclesRemovingParam

setDarkCirclesRemovingParam
setDarkCirclesRemovingParam(param: ZegoEffectsDarkCirclesRemovingParam): ZegoEffects
设置黑眼圈去除参数。

参数

名称类型描述
paramZegoEffectsDarkCirclesRemovingParam去除黑眼圈功能参数。

详情

设置黑眼圈去除参数。

setEyeliner

setEyeliner
setEyeliner(path?: string): ZegoEffects
设置眼线资源,设置 [null] 默认去除眼线效果。

参数

名称类型描述
pathstring眼线资源的绝对路径。

详情

开发者可调用 [setEyelinerParam] 进行设置眼线参数,当设置对应眼线资源时,会自动启动美妆眼线功能。

  • 支持版本:1.4.0。

setFaceShorteningParam

setFaceShorteningParam
setFaceShorteningParam(param: ZegoEffectsFaceShorteningParam): ZegoEffects
设置小脸参数。

参数

名称类型描述
paramZegoEffectsFaceShorteningParam小脸功能参数。

详情

设置小脸参数。

setForeheadShorteningParam

setForeheadShorteningParam
setForeheadShorteningParam(param: ZegoEffectsForeheadShorteningParam): ZegoEffects
设置缩小额头高度参数。

参数

名称类型描述
paramZegoEffectsForeheadShorteningParam缩小额头高度功能参数。

详情

设置缩小额头高度参数。

setMakeup

setMakeup
setMakeup(path?: string): ZegoEffects
设置风格妆资源,设置 [null] 默认去除风格妆效果。

参数

名称类型描述
pathstring风格妆资源的绝对路径。

详情

开发者可调用 [setMakeupParam] 进行设置风格妆参数,当设置对应风格妆资源时,会自动启动美妆风格妆功能。

  • 支持版本:1.4.0。

setMakeupParam

setMakeupParam
setMakeupParam(param: ZegoEffectsMakeupParam): ZegoEffects
设置风格妆参数。

参数

名称类型描述
paramZegoEffectsMakeupParam风格妆参数。

详情

设置风格妆参数。

setMandibleSlimmingParam

setMandibleSlimmingParam
setMandibleSlimmingParam(param: ZegoEffectsMandibleSlimmingParam): ZegoEffects
设置瘦下颌骨参数。

参数

名称类型描述
paramZegoEffectsMandibleSlimmingParam瘦下颌骨参数。

详情

设置瘦下颌骨参数。

setNoseLengtheningParam

setNoseLengtheningParam
setNoseLengtheningParam(param: ZegoEffectsNoseLengtheningParam): ZegoEffects
设置长鼻参数。

参数

名称类型描述
paramZegoEffectsNoseLengtheningParam长鼻功能参数。

详情

设置长鼻参数。

setSkinColorParam

setSkinColorParam
setSkinColorParam(param: ZegoEffectsSkinColorParam): ZegoEffects
设置换肤参数。

参数

名称类型描述
paramZegoEffectsSkinColorParam换肤功能强度参数。

详情

设置换肤参数。

setSkinColorResPath

setSkinColorResPath
setSkinColorResPath(bundlePath: string): ZegoEffects
设置换肤资源路径参数。

参数

名称类型描述
bundlePathstring换肤功能资源路径参数。

详情

在使用换肤时,需要调用 [enableSkinColor] 启用换肤功能后该接口设置的资源才能生效。

setWrinklesRemovingParam

setWrinklesRemovingParam
setWrinklesRemovingParam(param: ZegoEffectsWrinklesRemovingParam): ZegoEffects
设置法令纹去除参数。

参数

名称类型描述
paramZegoEffectsWrinklesRemovingParam去除黑眼圈功能参数。

详情

设置法令纹去除参数。

destroy

destroy
destroy(): void
销毁 Effects 对象。

用于释放 SDK 使用的资源。

enableEyesBrightening

enableEyesBrightening
enableEyesBrightening(enable: boolean): ZegoEffects
开启亮眼, 开发者可以调用 [setEyesBrighteningParam] 来设置亮眼参数。

参数

名称类型描述
enableboolean是否启动亮眼功能;[true] 表示启动亮眼功能;[false] 表示关闭亮眼功能。默认值为 [false]。

详情

开启亮眼, 开发者可以调用 [setEyesBrighteningParam] 来设置亮眼参数。

enableLongChin

enableLongChin
enableLongChin(enable: boolean): ZegoEffects
开启长下巴功能,可调用 [setLongChinParam] 接口设置长下巴参数。

参数

名称类型描述
enableboolean是否启动长下巴功能;[true] 表示启动长下巴功能;[false] 表示关闭长下巴功能。默认值为 [false]。

详情

开启长下巴功能,可调用 [setLongChinParam] 接口设置长下巴参数。

enableRosy

enableRosy
enableRosy(enable: boolean): ZegoEffects
开启红润功能,可调用 [setRosyParam] 接口设置红润参数。

参数

名称类型描述
enableboolean是否启动红润功能;[true] 表示启动红润功能;[false] 表示关闭红润功能。默认值为 [false]。

详情

开启红润功能,可调用 [setRosyParam] 接口设置红润参数。

enableSharpen

enableSharpen
enableSharpen(enable: boolean): ZegoEffects
开启锐化功能,可调用 [setSharpenParam] 接口设置锐化参数。

参数

名称类型描述
enableboolean是否启动锐化功能;[true] 表示启动锐化功能;[false] 表示关闭锐化功能。默认值为 [false]。

详情

开启锐化功能,可调用 [setSharpenParam] 接口设置锐化参数。

enableSmooth

enableSmooth
enableSmooth(enable: boolean): ZegoEffects
开启磨皮功能,可调用 [setSmoothParam] 接口设置磨皮参数。

参数

名称类型描述
enableboolean是否启动磨皮功能;[true] 表示启动磨皮功能;[false] 表示关闭磨皮功能。默认值为 [false]。

详情

开启磨皮功能,可调用 [setSmoothParam] 接口设置磨皮参数。

setEyelashes

setEyelashes
setEyelashes(path?: string): ZegoEffects
设置眼睫毛资源,设置 [null] 默认去除眼睫毛效果。

参数

名称类型描述
pathstring眼睫毛资源的绝对路径。

详情

开发者可调用 [setEyelashesParam] 进行设置眼睫毛参数,当设置对应眼睫毛资源时,会自动启动美妆眼睫毛功能。

  • 支持版本:1.4.0。

setEyelashesParam

setEyelashesParam
setEyelashesParam(param: ZegoEffectsEyelashesParam): ZegoEffects
设置眼睫毛参数。

参数

名称类型描述
paramZegoEffectsEyelashesParam眼睫毛参数。

详情

设置眼睫毛参数。

setEyelinerParam

setEyelinerParam
setEyelinerParam(param: ZegoEffectsEyelinerParam): ZegoEffects
设置眼线参数。

参数

名称类型描述
paramZegoEffectsEyelinerParam眼线参数。

详情

设置眼线参数。

setEyesBrighteningParam

setEyesBrighteningParam
setEyesBrighteningParam(param: ZegoEffectsEyesBrighteningParam): ZegoEffects
设置亮眼参数。

参数

名称类型描述
paramZegoEffectsEyesBrighteningParam亮眼功能参数。

详情

设置亮眼参数。

setEyeshadow

setEyeshadow
setEyeshadow(path?: string): ZegoEffects
设置眼影资源,设置 [null] 默认去除眼影效果。

参数

名称类型描述
pathstring眼影资源的绝对路径。

详情

开发者可调用 [setEyeshadowParam] 进行设置眼影参数,当设置对应眼影源时,会自动启动美妆眼影功能。

  • 支持版本:1.4.0。

setEyeshadowParam

setEyeshadowParam
setEyeshadowParam(param: ZegoEffectsEyeshadowParam): ZegoEffects
设置眼影参数。

参数

名称类型描述
paramZegoEffectsEyeshadowParam眼影参数。

详情

设置眼影参数。

setFilter

setFilter
setFilter(path?: string): ZegoEffects
设置滤镜资源,设置 [null] 默认去除滤镜。

参数

名称类型描述
pathstring滤镜资源的绝对路径。

详情

开发者可调用 [setFilterParam] 进行设置滤镜参数,当设置对应滤镜源时,会自动启动美滤镜功能。

  • 支持版本:1.1.0

setFilterParam

setFilterParam
setFilterParam(param: ZegoEffectsFilterParam): ZegoEffects
设置滤镜参数。

参数

名称类型描述
paramZegoEffectsFilterParam滤镜功能参数。

详情

设置滤镜参数。

setLipstick

setLipstick
setLipstick(path?: string): ZegoEffects
设置口红资源,设置 [null] 默认去除口红效果。

参数

名称类型描述
pathstring口红资源的绝对路径。

详情

开发者可调用 [setLipstickParam] 进行设置口红参数,当设置对应口红资源时,会自动启动美妆口红功能。

  • 支持版本:1.4.0。

setLipstickParam

setLipstickParam
setLipstickParam(param: ZegoEffectsLipstickParam): ZegoEffects
设置口红参数。

参数

名称类型描述
paramZegoEffectsLipstickParam口红参数。

详情

设置口红参数。

setLongChinParam

setLongChinParam
setLongChinParam(param: ZegoEffectsLongChinParam): ZegoEffects
设置长下巴参数。

参数

名称类型描述
paramZegoEffectsLongChinParam长下巴功能参数。

详情

设置长下巴参数。

setNoseNarrowingParam

setNoseNarrowingParam
setNoseNarrowingParam(param: ZegoEffectsNoseNarrowingParam): ZegoEffects
设置瘦鼻参数。

参数

名称类型描述
paramZegoEffectsNoseNarrowingParam瘦鼻参数。

详情

设置瘦鼻参数。

setRosyParam

setRosyParam
setRosyParam(param: ZegoEffectsRosyParam): ZegoEffects
设置红润参数。

参数

名称类型描述
paramZegoEffectsRosyParam红润功能参数。

详情

设置红润参数。

setSharpenParam

setSharpenParam
setSharpenParam(param: ZegoEffectsSharpenParam): ZegoEffects
设置锐化参数。

参数

名称类型描述
paramZegoEffectsSharpenParam锐化参数。

详情

设置锐化参数。

setSmallMouthParam

setSmallMouthParam
setSmallMouthParam(param: ZegoEffectsSmallMouthParam): ZegoEffects
设置小嘴参数。

参数

名称类型描述
paramZegoEffectsSmallMouthParam小嘴功能参数。

详情

设置小嘴参数。

setSmoothParam

setSmoothParam
setSmoothParam(param: ZegoEffectsSmoothParam): ZegoEffects
设置磨皮参数。

参数

名称类型描述
paramZegoEffectsSmoothParam磨皮功能参数。

详情

设置磨皮参数。

setTeethWhiteningParam

setTeethWhiteningParam
setTeethWhiteningParam(param: ZegoEffectsTeethWhiteningParam): ZegoEffects
设置白牙参数。

参数

名称类型描述
paramZegoEffectsTeethWhiteningParam白牙功能参数。

详情

设置白牙参数。

enableBigEyes

enableBigEyes
enableBigEyes(enable: boolean): ZegoEffects
使用后眼睛会变大。

参数

名称类型描述
enableboolean是否启动大眼功能;[true] 表示启动大眼功能;[false] 表示关闭大眼功能。默认值为 [false]。

详情

使用后眼睛会变大。

setBigEyesParam

setBigEyesParam
setBigEyesParam(param: ZegoEffectsBigEyesParam): ZegoEffects
设置大眼参数。

参数

名称类型描述
paramZegoEffectsBigEyesParam大眼功能参数。

详情

设置大眼参数。

enableTeethWhitening

enableTeethWhitening
enableTeethWhitening(enable: boolean): ZegoEffects
开启后牙齿会变得更白, 可以通过 [setTeethWhiteningParam] 接口设置参数。

参数

名称类型描述
enableboolean是否启动白牙功能;[true] 表示启动白牙功能;[false] 表示关闭白牙功能。默认值为 [false]。

详情

开启后牙齿会变得更白, 可以通过 [setTeethWhiteningParam] 接口设置参数。

enableWhiten

enableWhiten
enableWhiten(enable: boolean): ZegoEffects
开启美白功能。

参数

名称类型描述
enableboolean是否启动美白功能;[true] 表示启动美白功能;[false] 表示关闭美白功能。默认值为 [false]。

详情

开启美白功能。

setWhitenParam

setWhitenParam
setWhitenParam(param: ZegoEffectsWhitenParam): ZegoEffects
设置美白参数。

参数

名称类型描述
paramZegoEffectsWhitenParam美白功能参数。

详情

设置美白参数。

initEnv

initEnv
initEnv(width: number, height: number, resolution: CGSize): void
初始化 Effects 引擎环境。

参数

名称类型描述
widthnumber画面的宽度。
heightnumber画面的高度。
resolutionCGSize画面分辨率。

详情

在处理图像或视频数据前,需要调用该接口初始化 Effects 引擎环境。 注意:在第一次初始化时,如果有使用到 Al 相关的功能,该接口会产生耗时,请不要在主线程调用该接口,否则会造成 UI 线程卡顿。

setFaceLiftingParam

setFaceLiftingParam
setFaceLiftingParam(param: ZegoEffectsFaceLiftingParam): ZegoEffects
设置瘦脸参数。

参数

名称类型描述
paramZegoEffectsFaceLiftingParam瘦脸功能参数。

详情

设置瘦脸参数。

uninitEnv

uninitEnv
uninitEnv(): void
反初始化 Effects 引擎环境。

在停止使用摄像头进行采集时,可以调用该接口反初始化 Effects 引擎环境,反初始化会释放引擎内部一些耗资源的线程以及内存,另外反初始化后并不会释放已经加载的 Al 模型以及静态资源,只有销毁 SDK 才会释放,所以当下次再次使用 initEnv 时不会因为模型加载导致耗时。

enableChromaKey

enableChromaKey
enableChromaKey(enable: boolean): ZegoEffects
开启绿幕分割。

参数

名称类型描述
enableboolean是否启动绿幕分割功能;[true] 表示启动绿幕分割功能;[false] 表示关闭绿幕功能。默认值为 [false]。

详情

启动绿幕分割后引擎会把绿色作为关键颜色,并把绿色以外的颜色进行抠图,开发者可以通过 [enableChromaKeyBackground] [enableChromaKeyBackgroundBlur] [enableChromaKeyBackgroundMosaic] 接口修改绿幕自定义背景。

setChromaKeyBackgroundPath

setChromaKeyBackgroundPath
setChromaKeyBackgroundPath(imagePath: string, mode: ZegoEffectsScaleMode): ZegoEffects
设置绿幕自定义背景路径。

参数

名称类型描述
imagePathstring图片路径。
modeZegoEffectsScaleMode显示的视图模式。

详情

在使用自定义背景时,需要调用 [enableChromaKeyBackground] 启用自定义背景后该接口设置的背景才能生效。

setChromaKeyParam

setChromaKeyParam
setChromaKeyParam(param: ZegoEffectsChromaKeyParam): ZegoEffects
设置绿幕分割参数。

参数

名称类型描述
paramZegoEffectsChromaKeyParam绿幕分割功能参数。

详情

开发者可以通过该接口调整绿幕容差,关键色等参数。

enableChromaKeyBackground

enableChromaKeyBackground
enableChromaKeyBackground(enable: boolean): ZegoEffects
开启绿幕分割自定义背景后 SDK 引擎会将绿色作为关键颜色并替换成开发者设置的背景。

参数

名称类型描述
enableboolean是否启动绿幕分割自定义背景功能;[true] 表示启动绿幕分割自定义背景功能;[false] 表示关闭绿幕分割自定义背景功能。默认值为 [false]。

详情

开发者还可以通过 [setChromaKeyBackgroundBuffer] [setChromaKeyBackgroundPath] [setChromaKeyBackgroundTexture] 设置绿幕自定义背景。 注意:[enableChromaKeyBackgroundMosaic] [enableChromaKeyBackground] [enableChromaKeyBackgroundBlur] 中的接口只能启动其中一个,其中每次 enable 后都会覆盖前一个功能。

enableChromaKeyBackgroundBlur

enableChromaKeyBackgroundBlur
enableChromaKeyBackgroundBlur(enable: boolean): ZegoEffects
开启绿幕分割背景模糊。

参数

名称类型描述
enableboolean是否启动绿幕背景分割功能;[true] 表示启动绿幕背景分割功能;[false] 表示关闭绿幕背景分割功能。默认值为 [false]。

详情

开启绿幕分割背景模糊,启动后可通过 [setChromaKeyBackgroundBlurParam] 设置背景模糊参数。

enableChromaKeyBackgroundMosaic

enableChromaKeyBackgroundMosaic
enableChromaKeyBackgroundMosaic(enable: boolean): ZegoEffects
开启绿幕背景马赛克,启动后 SDK 引擎会把绿幕背景会变成马赛克。<br/>

参数

名称类型描述
enableboolean是否启动绿幕背景马赛克功能;[true] 表示启动绿幕背景马赛克功能;[false] 表示关闭绿幕背景马赛克功能。默认值为 [false]。

详情

开发者还可以通过 [setChromaKeyBackgroundMosaicParam] 设置绿幕马赛克参数。 注意:[enableChromaKeyBackgroundMosaic] [enableChromaKeyBackground] [enableChromaKeyBackgroundBlur] 中的接口只能启动其中一个,其中每次 enable 后都会覆盖前一个功能。

enablePortraitSegmentation

enablePortraitSegmentation
enablePortraitSegmentation(enable: boolean): ZegoEffects
开启 AI 人像分割。

参数

名称类型描述
enableboolean是否启动人像分割功能;[true] 表示启动人像分割功能;[false] 表示关闭人像分割功能。默认值为 [false]。

详情

开启 AI 人像分割,启动后 SDK 引擎会把人像进行抠图并把背景alpha通道改成 0,开发者可以通过使用透明的背景来达到在背景播放视频的目的。 开发者还可以通过 [enablePortraitSegmentationBackground] [enablePortraitSegmentationBackgroundMosaic] [enablePortraitSegmentationBackgroundBlur] 接口来设置自定义背景或马赛克背景或高斯模糊背景。 该功能适用于在背景播放视频或在背景播放ppt等业务场景。

enablePortraitSegmentationBackground

enablePortraitSegmentationBackground
enablePortraitSegmentationBackground(enable: boolean): ZegoEffects
开启 AI 人像分割自定义背景。

参数

名称类型描述
enableboolean是否启动AI人像分割自定义背景功能;[true] 表示启动AI人像分割自定义背景功能;[false] 表示关闭AI人像分割自定义背景功能。默认值为 [false]。

详情

开启 AI 人像分割自定义背景,启动后可通过 [setPortraitSegmentationBackgroundTexture] [setPortraitSegmentationBackgroundPath] [setPortraitSegmentationBackgroundBuffer] 等接口设置自定义背景。 SDK 会将人像抠图,并把人像放在开发者设置的背景图片上。

enablePortraitSegmentationBackgroundBlur

enablePortraitSegmentationBackgroundBlur
enablePortraitSegmentationBackgroundBlur(enable: boolean): ZegoEffects
开启 AI 人像分割背景模糊。

参数

名称类型描述
enableboolean是否启动人像分割背景模糊功能;[true] 表示启动人像分割背景模糊功能;[false] 表示关闭人像分割背景模糊功能。默认值为 [false]。

详情

开启 AI 人像分割背景模糊,启动后可通过 [setPortraitSegmentationBackgroundBlurParam] 设置背景模糊参数。

enablePortraitSegmentationBackgroundMosaic

enablePortraitSegmentationBackgroundMosaic
enablePortraitSegmentationBackgroundMosaic(enable: boolean): ZegoEffects
开启 Al 人像分割背景马赛克

参数

名称类型描述
enableboolean是否启动人像分割背景马赛克功能;[true] 表示启动人像分割背景马赛克功能;[false] 表示关闭人像分割背景马赛克功能。默认值为 [false]。

详情

开启 Al 人像分割背景马赛克,启动后可通过 [setPortraitSegmentationBackgroundMosaicParam] 设置马赛克类型。

setChromaKeyBackgroundBlurParam

setChromaKeyBackgroundBlurParam
setChromaKeyBackgroundBlurParam(param: ZegoEffectsBlurParam): ZegoEffects
设置绿幕背景模糊参数。

参数

名称类型描述
paramZegoEffectsBlurParam绿幕背景模糊功能参数。

详情

在使用背景模糊时,需要调用 [enableChromaKeyBackgroundBlur] 启用背景模糊后该接口设置的背景才能生效。

setChromaKeyBackgroundMosaicParam

setChromaKeyBackgroundMosaicParam
setChromaKeyBackgroundMosaicParam(param: ZegoEffectsMosaicParam): ZegoEffects
设置绿幕分割背景马赛克参数。

参数

名称类型描述
paramZegoEffectsMosaicParam马赛克参数。

详情

需要调用 [enableChromaKeyBackgroundMosaic] 启用背景马赛克后该接口设置的背景才能生效。

setPortraitSegmentationBackgroundBlurParam

setPortraitSegmentationBackgroundBlurParam
setPortraitSegmentationBackgroundBlurParam(param: ZegoEffectsBlurParam): ZegoEffects
设置 AI 人像分割背景模糊参数。

参数

名称类型描述
paramZegoEffectsBlurParam人像分割背景模糊功能参数。

详情

在使用背景模糊时,需要调用 [enablePortraitSegmentationBackgroundBlur] 启用背景模糊后该接口设置的背景才能生效。

setPortraitSegmentationBackgroundMosaicParam

setPortraitSegmentationBackgroundMosaicParam
setPortraitSegmentationBackgroundMosaicParam(param: ZegoEffectsMosaicParam): ZegoEffects
设置 Al 人像分割背景马赛克参数。

参数

名称类型描述
paramZegoEffectsMosaicParam马赛克参数。

详情

需要调用 [enablePortraitSegmentationBackgroundMosaic] 启用背景马赛克后该接口设置的背景才能生效。

setPortraitSegmentationBackgroundPath

setPortraitSegmentationBackgroundPath
setPortraitSegmentationBackgroundPath(imagePath?: string, mode: ZegoEffectsScaleMode): ZegoEffects
设置 AI 人像分割自定义背景路径。

参数

名称类型描述
imagePathstring图片路径。
modeZegoEffectsScaleMode显示的视图模式。

详情

在使用自定义背景时,需要调用 [enablePortraitSegmentationBackground] 启用自定义背景后该接口设置的背景才能生效。

enableFaceDetection

enableFaceDetection
enableFaceDetection(enable: boolean): ZegoEffects
开启人脸检测。

参数

名称类型描述
enableboolean是否启动人脸检测功能;[true] 表示启动人脸检测功能;[false] 表示关闭去除人脸检测功能。默认值为 [false]。

详情

启动人脸检测后,开发者可通过 [ZegoEffectsEventHandler] 中的 [onFaceDetectionResult] 来获取人脸检测结果,包括人脸数量,人脸坐标等。

enableFaceLifting

enableFaceLifting
enableFaceLifting(enable: boolean): ZegoEffects
开启后脸会变得更苗条,下巴更瘦。

参数

名称类型描述
enableboolean是否启动瘦脸功能;[true] 表示启动瘦脸功能;[false] 表示关闭瘦脸功能。默认值为 [false]。

详情

开启后脸会变得更苗条,下巴更瘦。

enableNoseNarrowing

enableNoseNarrowing
enableNoseNarrowing(enable: boolean): ZegoEffects
开启瘦鼻功能,你可以调用 [setNoseNarrowingParam] 接口来设置参数。

参数

名称类型描述
enableboolean是否启动瘦鼻功能;[true] 表示启动瘦鼻功能;[false] 表示关闭瘦鼻功能。默认值为 [false]。

详情

开启瘦鼻功能,你可以调用 [setNoseNarrowingParam] 接口来设置参数。

enableSmallMouth

enableSmallMouth
enableSmallMouth(enable: boolean): ZegoEffects
开启长小嘴功能,可调用 [setSmallMouthParam] 接口设置参数。

参数

名称类型描述
enableboolean是否启动长小嘴功能;[true] 表示启动长小嘴功能;[false] 表示关闭长小嘴功能。默认值为 [false]。

详情

开启长小嘴功能,可调用 [setSmallMouthParam] 接口设置参数。

on

on
on(errorCode: number, desc: string): void
错误信息回调。

参数

名称类型描述
errorCodenumber引擎错误码。
descstring引擎错误码描述。

详情

调用 SDK 函数出现异常时,会通过该回调提示详细的异常信息。

ZegoEffectsAdvancedConfig

引擎配置类

  • 注意事项:必须在创建 effects 之前调用。

属性

advancedConfig

advancedConfig
advancedConfig: HashMap<String, String>

其他特殊功能开关,如渲染模式,设备性能等级等。如果不设置,默认不使用特殊功能。 使用前请联系ZEGO技术支持。

ZegoEffectsBigEyesParam

开发者可通过该类调整大眼属性。

详情

开发者可以通过该类修改大眼强度。

属性

intensity

intensity
intensity: number

大眼强度,取值范围 [0~100]。

ZegoEffectsBlurParam

开发者可通过该类调整模糊属性。

详情

开发者可以通过该类修改模糊强度。

属性

intensity

intensity
intensity: number

模糊强度,取值范围 [0~100]。

ZegoEffectsBlusherParam

开发者可通过该类调整腮红参数。

详情

开发者可通过该类调整腮红参数。

属性

intensity

intensity
intensity: number

详情信息:腮红强度,范围 [0~100]。

ZegoEffectsCheekParam

腮红参数。

详情

开发者可通过该类修改腮红强度等参数。

属性

intensity

intensity
intensity: number

腮红强度,取值范围 [0~100]。

ZegoEffectsCheekboneSlimmingParam

开发者可通过该类调整瘦颧骨参数。

详情

开发者可通过该类调整瘦颧骨参数。

属性

intensity

intensity
intensity: number

详情信息:瘦颧骨强度,范围 [0~100]。

ZegoEffectsChromaKeyParam

绿幕参数类。

详情

开发者可以按需设置绿幕参数。

属性

similarity

similarity
similarity: number

更新颜色容差,容差越大,被替换的范围越大,范围 [0~100] ,默认 67。

smoothness

smoothness
smoothness: number

更新边缘平滑指数,越大越平滑,但渲染也会越慢,范围 [0~100] ,默认 80。

opacity

opacity
opacity: number

更新透明度,范围 [0~100],默认 100 (不透明)。

keyColor

keyColor
keyColor: number

更新要替换的颜色,格式:BGR,范围 [0,0xFFFFFF],默认 0x00FF00。

borderSize

borderSize
borderSize: number

更新边缘像素采样半径,borderSize 越大边缘颜色过度越平缓,速度也越慢,背景和前景交接处的像素经常会有残留绿色,取附近像素平均值作为新的像素值,来去除残留,范围 [0~100],默认 1。

ZegoEffectsColoredcontactsParam

开发者可通过该类调整美瞳参数。

详情

开发者可通过该类调整美瞳参数。

属性

intensity

intensity
intensity: number

详情信息:美瞳强度,范围 [0~100]。

ZegoEffectsDarkCirclesRemovingParam

开发者可通过该类调整黑眼圈去除参数。

详情

开发者可通过该类调整黑眼圈去除参数。

属性

intensity

intensity
intensity: number

详情信息:黑眼圈去除强度,范围 [0~100]。

ZegoEffectsEyelashesParam

开发者可通过该类调整眼睫毛参数。

详情

开发者可通过该类调整眼睫毛参数。

属性

intensity

intensity
intensity: number

详情信息:眼睫毛强度,范围 [0~100]。

ZegoEffectsEyelinerParam

开发者可通过该类调整眼线参数。

详情

开发者可通过该类调整眼线参数。

属性

intensity

intensity
intensity: number

详情信息:眼线强度,范围 [0~100]。

ZegoEffectsEyesBrighteningParam

亮眼参数。

详情

开发者可以通过该类设置亮眼强度等参数。

属性

intensity

intensity
intensity: number

亮眼强度,范围 [0~100]。

ZegoEffectsEyeshadowParam

开发者可通过该类调整眼影属性。

详情

开发者可通过该类调整眼影属性。

属性

intensity

intensity
intensity: number

详情信息:眼影强度,范围 [0~100]。

ZegoEffectsFaceDetectionResult

人脸检测数据。

详情

人脸检测数据。

属性

score

score
score: number

人脸的置信度, 越大表示更大概率是人脸。

rect

rect
rect: ZegoEffectsRect

人脸所在的矩形框, 完全包括了整个人脸, 单位是像素, 坐标系在输入图像的左上角。

ZegoEffectsFaceLiftingParam

开发者可通过该类调整瘦脸参数。

详情

开发者可通过该类调整瘦脸参数。

属性

intensity

intensity
intensity: number

详情信息:瘦脸强度,范围 [-100~100]。

ZegoEffectsFaceShorteningParam

开发者可通过该类调整小脸参数。

详情

开发者可通过该类调整小脸参数。

属性

intensity

intensity
intensity: number

详情信息:小脸强度,范围 [0~100]。

ZegoEffectsFilterParam

滤镜风格参数。

详情

滤镜风格参数。

属性

intensity

intensity
intensity: number

详情信息:开发者可通过该属性调整滤镜强度。

ZegoEffectsForeheadShorteningParam

开发者可通过该类调整缩小额头高度参数。

详情

开发者可通过该类调整缩小额头高度参数。

属性

intensity

intensity
intensity: number

缩小额头高度强度,范围 [-100~100]。

ZegoEffectsLipstickParam

开发者可通过该类调整口红参数。

详情

开发者可通过该类调整口红参数。

属性

intensity

intensity
intensity: number

详情信息:口红强度,范围 [0~100]。

ZegoEffectsLongChinParam

开发者可通过该类调整下巴参数。

详情

开发者可通过该类调整下巴参数。

属性

intensity

intensity
intensity: number

长下巴强度,范围 [-100~100]。

ZegoEffectsMakeupParam

开发者可通过该类调整风格妆参数。

详情

开发者可通过该类调整风格妆参数。

属性

intensity

intensity
intensity: number

详情信息:风格妆强度,范围 [0~100]。

ZegoEffectsMandibleSlimmingParam

开发者可通过该类调整瘦下颌骨参数。

详情

开发者可通过该类调整瘦下颌骨参数。

属性

intensity

intensity
intensity: number

详情信息:瘦下颌骨强度,范围 [0~100]。

ZegoEffectsMosaicParam

马赛克参数。

详情

马赛克参数。

属性

intensity

intensity
intensity: number

马赛克强度 [0~100]。

type

type

设置马赛克类型,默认为三角形。

ZegoEffectsNoseLengtheningParam

长鼻强度,范围 [-100~100]。

详情

详情信息:长鼻强度,范围 [-100~100]。

属性

intensity

intensity
intensity: number

详情信息:长鼻强度,范围 [-100~100]。

ZegoEffectsNoseNarrowingParam

开发者可以通过该类调整瘦鼻参数。

详情

开发者可以通过该类调整瘦鼻参数。

属性

intensity

intensity
intensity: number

瘦鼻强度,范围 [0-100]。

ZegoEffectsRosyParam

开发者可通过该类调整红润参数。

详情

开发者可通过该类调整红润参数。

属性

intensity

intensity
intensity: number

详情信息:红润强度,范围 [0~100]。

ZegoEffectsSharpenParam

开发者可通过该类调整锐化参数。

详情

开发者可通过该类调整锐化参数。

属性

intensity

intensity
intensity: number

详情信息:锐化强度,范围 [0~100]。

ZegoEffectsSmallMouthParam

开发者可通过该类调整小嘴参数。

详情

开发者可通过该类调整小嘴参数。

属性

intensity

intensity
intensity: number

详情信息:小嘴强度,范围 [-100~100]。

ZegoEffectsSmoothParam

开发者可通过该类调整磨皮参数。

详情

开发者可通过该类调整磨皮参数。

属性

intensity

intensity
intensity: number

详情信息:磨皮强度,范围 [0~100]。

ZegoEffectsTeethWhiteningParam

开发者可通过该类调整白牙参数。

详情

开发者可通过该类调整白牙参数。

属性

intensity

intensity
intensity: number

详情信息:白牙强度,范围 [0~100]。

ZegoEffectsVideoFrameParam

视频帧详细参数。

详情

视频帧详细参数。

属性

width

width
width: number

视频帧宽度,单位为像素。

height

height
height: number

视频帧高度,单位为像素。

format

format
format: ZegoEffectsVideoFrameFormat

视频数据帧格式。

textureFormat

textureFormat
textureFormat: ZegoEffectsTextureFormat

纹理格式,如果是传递纹理,可以指定对应纹理的格式,2D 纹理还是 OES 纹理( Android 特有格式)。

tranMatrix

tranMatrix
tranMatrix: number

2D 纹理是 OES 纹理( Android 特有格式)时,传入纹理变换矩阵,可以从SurfaceTexture的getTransformMatrix(float[] mtx)接口获取。

  • 平台差异:只在Android平台的OES纹理时有效。

ZegoEffectsWhitenParam

美白参数。

详情

开发者可以通过该类修改美白参数。

属性

intensity

intensity
intensity: number

美白强度,范围 [0~100]。

ZegoEffectsWrinklesRemovingParam

开发者可通过该类调整法令纹去除参数。

详情

开发者可通过该类调整法令纹去除参数。

属性

intensity

intensity
intensity: number

详情信息:法令纹去除强度,范围 [-100~100]。

上一篇

功能总览

下一篇

Struct