滤镜

功能简介

ZegoEffects SDK 提供滤镜功能，包含多种滤镜风格可使用，可广泛应用于短视频，直播等场景。

前提条件

在使用 ZegoEffects SDK 滤镜功能前，请确保已在项目中集成 ZegoEffects SDK，实现基本的图像处理功能，详情请参考 快速开始 - 集成 SDK。

使用步骤

滤镜功能提供了以下风格：

• 自然（Natural）：奶油（Creamy）、青春（Brighten）、清新（Fresh）、秋天（Autumn）
• 灰调（Gray）：莫奈（Cool）、暗夜（Night）、胶片（Film-like）
• 梦境（Dreamy）：落日（Sunset）、琉璃（Cozily）、星云（Sweet）

开发者在调用接口时，可以根据需要，选择对应的滤镜资源使用。

开启滤镜功能之后，开发者可根据实际的需求来自定义滤镜参数。如果未自定义，SDK 将采用默认参数值实现滤镜功能。

开启滤镜

调用 setFilter 接口开启/关闭滤镜功能，传入对应的滤镜绝对路径。调用 setFilterParam 接口设置滤镜强度。

ZegoEffectsFilterParam 对象的滤镜强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。

// 开启滤镜功能
// 1. 开启滤镜功能，并且传入对应的滤镜绝对路径
[self.effects setFilter:@"/xxx/xxx/Night.bundle"];

// 设置滤镜强度，范围 [0, 100]
ZegoEffectsFilterParam *param = [[ZegoEffectsFilterParam alloc] init];
param.intensity = 100;
[self.effects setFilterParam:param];

// 开启滤镜功能
// 1. 开启滤镜功能，并且传入对应的滤镜绝对路径
mEffects.setFilter("/xxx/xxx/Night.bundle");

// 设置滤镜强度，范围 [0, 100]
ZegoEffectsFilterParam param = new ZegoEffectsFilterParam();
param.intensity = 100;
mEffects.setFilterParam(param);

// 开启滤镜功能
// 1. 开启滤镜功能，并且传入对应的滤镜绝对路径
zego_effects_set_filter(handle,"/xxx/xxx/Night.bundle");

// 设置滤镜强度，范围 [0, 100]
zego_effects_filter_param param;
param.intensity = 100;
zego_effects_set_filter_param(handle,param);

// 开启滤镜功能
// 1. 开启滤镜功能，并且传入对应的滤镜绝对路径
ZegoEffectsPlugin.instance.setFilter('Night');

// 设置滤镜强度，范围 [0, 100]
ZegoEffectsFilterParam param = ZegoEffectsFilterParam();
param.intensity = 100;
ZegoEffectsPlugin.instance.setFilterParam(param);

// 开启绿幕分割背景虚化
mEffects.enableChromaKeyBackgroundBlur(true);

// 设置绿幕分割背景虚化参数
mEffects.setChromaKeyBackgroundBlurParam({ intensity: 100 });

移除滤镜。

如果需要移除滤镜，可将 null 传入 setFilter 接口。

// 移除滤镜功能
[self.effects setFilter:nil];

// 移除滤镜功能
mEffects.setFilter(null);

// 移除滤镜功能
zego_effects_set_filter(handle,"");

// 移除滤镜功能
ZegoEffectsPlugin.instance.setFilter('');

// 开启绿幕分割背景马赛克
mEffects.enableChromaKeyBackgroundMosaic(true);

// 设置绿幕分割背景马赛克参数
mEffects.setChromaKeyBackgroundMosaicParam({ intensity: 100 });