推流视频增强
功能简介
ZEGO Express SDK 提供多种视频前处理增强能力，开发者可以根据业务需要，在推流端对画面的效果进行调整。
| 功能 | 功能描述 | 功能优势 | 效果展示 | |
|---|---|---|---|---|
| 基础美颜 | 根据用户和业务需要，调整美白、磨皮、锐化以及红润的程度，轻松实现基础美颜功能，为用户呈现出良好的肌肤状态，打造独特自然的美颜效果。 | 覆盖高频使用的美颜能力。 |  | |
| 低照度增强 | 在环境光较暗的情况下，摄像头采集到的画面亮度不满足看清人脸、或无法进行人脸识别等业务需求时，对画面亮度进行增强。 |
|  |  |
| 视频降噪 | 摄像头的采集效果不佳、环境光亮度较低等情况，可能会造成画面出现明显的噪点，通过视频降噪功能可减少画面的噪点。 |
|  |  |
| 色彩增强 | 由于摄像头的特性，采集到的视频可能存在饱和度不足的问题。使用色彩增强功能，在保护人物肤色的情况下，增强欠饱和的色彩，让画面色彩更逼真，更符合人的视觉感受。 |
|  |  |
前提条件
在使用推流视频增强功能前，请确保：
- 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
- 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
使用步骤
1 初始化和登录房间
初始化和登录房间的具体流程，请参考实现视频通话文档中的 “创建引擎” 及 “登录房间”。
2 设置推流视频增强效果
请根据需要，选择对应的功能进行配置。
此功能为 ZEGO Express SDK 内置 ZEGO Effects SDK 的基础美颜功能，仅包含美白、红润、磨皮、锐化四种美颜效果。如需使用更多进阶的美颜功能，请参考 实时音视频和 AI 美颜的搭配使用。
初始化基础美颜环境
若您需要使用基础美颜功能，则必须在 startPreview 开始预览、startPublishingStream 推流前，调用 startEffectsEnv 接口初始化美颜环境。
在 Web 平台，不需要额外开启美颜环境，可无需调用 startEffectsEnv 。
// 创建美颜环境
ZegoExpressEngine.instance.startEffectsEnv();开关基础美颜效果
- enableEffectsBeauty 接口和 setEffectsBeautyParam 接口的调用时序无先后之分。
- 在 Web 平台，需要在推流前执行 enableEffectsBeauty 和 setEffectsBeautyParam ，美颜效果才会生效。
初始化美颜环境后，您可以在推流前后（Web 平台需要在推流前），调用 enableEffectsBeauty 接口实时开启或关闭美颜效果。
// 开关美颜效果
ZegoExpressEngine.instance.enableEffectsBeauty(true);设置基础美颜效果参数
初始化美颜环境后，您可以在推流前后，调用 setEffectsBeautyParam 接口实时设置美颜效果参数。
- smoothIntensity：磨皮，在保留脸部细节的基础上进行磨皮，例如脸上的痣会保留。
- whitenIntensity：美白，对画面整体调高亮度来美白脸部。
- rosyIntensity：红润，对画面整体进行暖色处理。
- sharpenIntensity：锐化，对画面整体进行锐化处理，当画面有些模糊时可以稍微调大锐化使轮廓清晰。
以上四个参数的取值范围都为 0 ～ 100，取值越大，美颜程度越高，默认值为 50。
// 创建美颜参数对象
var beautyParam = ZegoEffectsBeautyParam.defaultParam();
// 美白、红润、磨皮、锐化
beautyParam.whitenIntensity = 50;
beautyParam.rosyIntensity = 50;
beautyParam.smoothIntensity = 50;
beautyParam.sharpenIntensity = 50;
// 设置美颜参数
ZegoExpressEngine.instance.setEffectsBeautyParam(beautyParam);（可选）销毁基础美颜环境
当调用 enableEffectsBeauty 接口设为 “false” 时，会关闭美颜效果，但美颜模块还是会占用资源并消耗性能。如果想彻底释放资源，节省性能消耗，则需要在预览和推流前调用 stopEffectsEnv 接口销毁美颜环境。
- 当调用 destroyEngine 销毁引擎的同时，SDK 会自动销毁美颜环境。
- 在 Web 平台，由于不需要额外开启美颜环境，因此可不调用 stopEffectsEnv。如需停止美颜效果，可执行 stopEffectsEnv 或将 enableEffectsBeauty 接口设为 “false” 。若不执行 stopEffectsEnv 或未将 enableEffectsBeauty 接口设为 “false” ，在停止推流或者停止预览流时，流会被销毁，美颜效果也会消失。
// 销毁美颜环境
ZegoExpressEngine.instance.stopEffectsEnv();ZEGO 提供两种低照度增强的方式：
| 方式 | 描述 |
|---|---|
| 开启自适应帧率进行增强 | 在设定的帧率范围内动态降低采集帧率，以延长每一帧的画面曝光时间，达到增强采集到的画面亮度的效果。
例如：开发者开启并设置自适应帧率范围为 [10, 25]。环境光照充足的时候，采集帧率依然是 25 帧，环境光照度较低的时候，采集帧率会在 [10, 25] 之间动态调整，以延长每一帧的曝光时间增强采集画面的亮度。 |
| 算法对采集到的画面亮度进行增强 |
|
两种处理方式可以独立使用，也可以同时使用，均兼容美颜功能。
设置低照度增强模式
RTC SDK 支持不同的算法低照度增强模式，调用 setLowlightEnhancementParams 接口进行设置低照度增强模式 ZegoLowlightEnhancementMode：
| 枚举值 | 说明 |
|---|---|
| ZegoLowlightEnhancementMode.Off | 关闭低照度增强功能。 |
| ZegoLowlightEnhancementMode.On | 开启低照度增强功能，由开发者自主控制。 |
| ZegoLowlightEnhancementMode.Auto | 智能控制低照度增强功能，根据画面光照情况，智能开启或关闭功能。 |
低照度增强类型 ZegoExpLowlightEnhancementType 包括如下类型：
| 枚举值 | 说明 |
|---|---|
| ZegoExpLowlightEnhancementType.Normal | 常规低照度增强。 |
| ZegoExpLowlightEnhancementType.AI | AI 低照度增强。如需要使用此功能，需要联系 ZEGO 技术支持。 |
以开启自动低照度增强功能为例：
ZegoExpLowlightEnhancementParams params = ZegoExpLowlightEnhancementParams(ZegoLowlightEnhancementMode.Auto, ZegoExpLowlightEnhancementType.Normal);
ZegoExpressEngine.instance.setLowlightEnhancementParams(params, channel: ZegoPublishChannel.Main);（可选）开启摄像头自适应帧率
当环境光照度较低，且摄像头采集帧率过高时，每一帧画面的曝光时间不足，可能导致采集的视频画面偏暗，此时可以通过 enableCameraAdaptiveFPS 开启摄像头自适应帧率。SDK 会根据设置的帧率范围匹配摄像头支持的采集帧率范围，在此范围内，根据环境亮度动态调整摄像头采集帧率，提升设置的帧率过高时的画面亮度。
//设置最小帧率
int minCamFPS = 15;
//设置最大帧率
int maxCamFPS = 35;
ZegoExpressEngine.instance.enableCameraAdaptiveFPS(true, minCamFPS, maxCamFPS, ZegoPublishChannel.Main);调用 setVideoDenoiseParams 接口，设置视频降噪参数 ZegoVideoDenoiseParams 包括：视频降噪模式 ZegoVideoDenoiseMode 及视频降噪强度 ZegoVideoDenoiseStrength。
默认不开启视频降噪功能，即 ZegoVideoDenoiseMode 默认值为 ZegoVideoDenoiseMode.off。
以设置自动降噪为例：
ZegoVideoDenoiseParams p = ZegoVideoDenoiseParams(ZegoVideoDenoiseMode.Auto, ZegoVideoDenoiseStrength.Light);
ZegoExpressEngine.instance.setVideoDenoiseParams(p, channel: ZegoPublishChannel.Main);调用 enableColorEnhancement 接口，设置色彩增强参数 ZegoColorEnhancementParams（参数属性如下表）、以及其它参数，开启色彩增强功能。默认不开启色彩增强功能。
| 色彩增强参数 | 描述 |
|---|---|
| intensity | 色彩增强的强度，取值范围 [0.0, 1.0]，默认为 0.0。 取值越大，色彩增强的效果越大。 |
| skinToneProtectionLevel | 肤色保护的强度，取值范围 [0.0, 1.0]，默认为 1.0。 取值越大，保护效果越好。 |
| lipColorProtectionLevel | 唇色保护的强度，取值范围 [0.0, 1.0]，默认为 0.0。 取值越大，保护效果越好。 |
ZegoColorEnhancementParams p = ZegoColorEnhancementParams.defaultParam();
p.intensity = 1; //取值范围：[0,1]，取值越大，色彩增强的强度越大。默认值：0。
p.skinToneProtectionLevel = 1; //取值范围：[0,1]，取值越大，肤色保护程度越大。默认值：1。
p.lipColorProtectionLevel = 1; //取值范围：[0,1]，取值越大，唇色保护程度越大。默认值：0。
ZegoExpressEngine.instance.enableColorEnhancement(true, p, channel: ZegoPublishChannel.Main);//开启色彩增强3 开始预览
调用 startPreview 接口开启预览后，可以设置不同的视频增强功能，并实时体验效果。
获取预览用的 Widget，然后使用 viewID 创建一个 ZegoCanvas 对象，开始预览。
// 将此 Widget 加入到页面的渲染树中以显示预览画面
_previewViewWidget = await ZegoExpressEngine.instance.createCanvasView((viewID) {
_previewViewID = viewID;
// Set the preview canvas
ZegoCanvas previewCanvas = ZegoCanvas.view(viewID);
// Start preview
ZegoExpressEngine.instance.startPreview(canvas: previewCanvas);
});4 开始推流
当预览效果达到预期后，可以调用 startPublishingStream 接口开始推流，推流画面效果将与预览效果一致。
ZegoExpressEngine.instance.startPublishingStream("streamID");以上，即可实现推流前视频增强功能。