进阶 - 推流视频增强

1 初始化基础美颜环境

若您需要使用基础美颜功能，则必须在 startPreview 开始预览、startPublishingStream 推流前，调用 startEffectsEnv 接口初始化美颜环境。

// 创建美颜环境
[[ZegoExpressEngine sharedInstance] startEffectsEnv];

当初始化美颜环境后，SDK 内部会使用固定的视频帧数据类型进行传输，如果您使用基础美颜功能时还需要使用到视频自定义前处理，则只能配置相对应的视频帧数据类型：

iOS 和 macOS 平台：只支持 CVPixelBuffer 类型的数据，即 ZegoCustomVideoCaptureConfig 的 bufferType 取值为 “ZegoVideoBufferTypeCVPixelBuffer”。

2 开启基础美颜效果

初始化美颜环境后，您可以在推流前后，调用 enableEffectsBeauty 接口实时开启或关闭美颜效果。

// 开关美颜效果
[[ZegoExpressEngine sharedInstance] enableEffectsBeauty:true];

3 设置基础美颜效果参数

初始化美颜环境后，您可以在推流前后，调用 setEffectsBeautyParam 接口实时设置美颜效果参数。

• smoothIntensity：磨皮，在保留脸部细节的基础上进行磨皮，比如脸上的痣会保留。
• whitenIntensity：美白，对画面整体调高亮度来美白脸部。
• rosyIntensity：红润，对画面整体进行暖色处理。
• sharpenIntensity：锐化，对画面整体进行锐化处理，当画面有些模糊时可以稍微调大锐化使轮廓清晰。

以上四个参数的取值范围都为 0 ～ 100，取值越大美颜程度越高，默认值为 50。

// 创建美颜参数对象
ZegoEffectsBeautyParam *beautyParam = [[ZegoEffectsBeautyParam alloc] init];

// 美白、红润、磨皮、锐化
beautyParam.whitenIntensity = 50;
beautyParam.rosyIntensity = 50;
beautyParam.smoothIntensity = 50;
beautyParam.sharpenIntensity = 50;

// 设置美颜参数
[[ZegoExpressEngine sharedInstance] setEffectsBeautyParam:beautyParam];

（可选）销毁基础美颜环境

当调用 enableEffectsBeauty 接口设为 “false” 时，会关闭美颜效果，但美颜模块还是会占用资源并消耗性能。如果想彻底释放资源，节省性能消耗，则需要在预览和推流前调用 stopEffectsEnv 接口销毁美颜环境。

// 销毁美颜环境
[[ZegoExpressEngine sharedInstance] stopEffectsEnv];

ZEGO 提供两种低照度增强的方式：

两种处理方式可以独立使用，也可以同时使用，均兼容美颜功能。

1 设置低照度增强模式

RTC SDK 支持不同的算法低照度增强模式，调用 setLowlightEnhancement 接口进行设置低照度增强模式 ZegoLowlightEnhancementMode：

以开启自动低照度增强功能为例：

[[ZegoExpressEngine sharedEngine] setLowlightEnhancement:ZegoLowlightEnhancementModeAuto channel:ZegoPublishChannelMain];

2 （可选）开启摄像头自适应帧率

当环境光照度较低，且摄像头采集帧率过高时，每一帧画面的曝光时间不足，可能导致采集的视频画面偏暗，此时可以通过 enableCameraAdaptiveFPS 开启摄像头自适应帧率。SDK 会根据设置的帧率范围匹配摄像头支持的采集帧率范围，在此范围内，根据环境亮度动态调整摄像头采集帧率，提升设置的帧率过高时的画面亮度。

//设置最小帧率
int minCamFPS = 15;
//设置最大帧率
int maxCamFPS = 35;
[[ZegoExpressEngine sharedEngine] enableCameraAdaptiveFPS:YES minFPS:minCamFPS maxFPS:maxCamFPS channel:ZegoPublishChannelMain];

调用 enableColorEnhancement 接口，设置色彩增强参数 ZegoColorEnhancementParams（参数属性如下表）、以及其它参数，开启色彩增强功能。默认不开启色彩增强功能。

ZegoColorEnhancementParams *p = [[ZegoColorEnhancementParams alloc]init];
p.intensity = 1f;//取值范围：[0,1]，取值越大，色彩增强的强度越大。默认值：0。
p.skinToneProtectionLevel = 1f;//取值范围：[0,1]，取值越大，肤色保护程度越大。默认值：1。
p.lipColorProtectionLevel = 1f;//取值范围：[0,1]，取值越大，唇色保护程度越大。默认值：0。
[[ZegoExpressEngine sharedEngine]enableColorEnhancement:YES params:p channel:ZegoPublishChannelMain];//开启色彩增强