文档中心
ExpressVideoSDK 实时音视频
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 实时音视频
  • 视频能力
  • 推流视频增强

推流视频增强

更新时间:2025-01-20 22:09

功能简介

ZEGO Express SDK 提供多种视频前处理增强能力,开发者可以根据业务需要,在推流端对画面的效果进行调整。

功能 功能描述 功能优势 效果展示
基础美颜
根据用户和业务需要,调整美白、磨皮、锐化以及红润的程度,轻松实现基础美颜功能,为用户呈现出良好的肌肤状态,打造独特自然的美颜效果。
覆盖高频使用的美颜能力。
低照度增强
在环境光较暗的情况下,摄像头采集到的画面亮度不满足看清人脸、或无法进行人脸识别等业务需求时,对画面亮度进行增强。
  • 极小性能开销,全机型覆盖。
  • 支持自动增强模式,自动识别低照度环境。
色彩增强
由于摄像头的特性,采集到的视频可能存在饱和度不足的问题。使用色彩增强功能,在保护人物肤色的情况下,增强欠饱和的色彩,让画面色彩更逼真,更符合人的视觉感受。
  • 保护肤色,避免人物肤色受到增强。
  • 保护唇色,在美颜和带妆时,使嘴唇色彩更自然。

前提条件

在使用推流视频增强功能前,请确保:

  • 已在 ZEGO 控制台 创建项目,并申请有效的 AppID 和 AppSign,详情请参考 控制台 - 项目信息。
  • 已在项目中集成 ZEGO Express SDK,并实现了基本的音视频推拉流功能,详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

使用步骤

1 初始化和登录房间

初始化和登录房间的具体流程,请参考实现视频通话文档中的 “创建引擎” 及 “登录房间”。

2 设置推流视频增强效果

请根据需要,选择对应的功能进行配置。

基础美颜

此功能为 ZEGO Express SDK 内置 ZEGO Effects SDK 的基础美颜功能,仅包含美白、红润、磨皮、锐化四种美颜效果。如需使用更多进阶的美颜功能,请参考 实时音视频和 AI 美颜的搭配使用。

1 初始化基础美颜环境

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

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

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

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

2 开启基础美颜效果

enableEffectsBeauty 接口和 setEffectsBeautyParam 接口的调用时序无先后之分。

初始化美颜环境后,您可以在推流前后,调用 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 接口销毁美颜环境。

当调用 destroyEngine 销毁引擎的同时,SDK 会自动销毁美颜环境。

// 销毁美颜环境
[[ZegoExpressEngine sharedInstance] stopEffectsEnv];
低照度增强

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

方式 描述
开启自适应帧率进行增强
在设定的帧率范围内动态降低采集帧率,以延长每一帧的画面曝光时间,达到增强采集到的画面亮度的效果。
例如:开发者开启并设置自适应帧率范围为 [10, 25]。环境光照充足的时候,采集帧率依然是 25 帧,环境光照度较低的时候,采集帧率会在 [10, 25] 之间动态调整,以延长每一帧的曝光时间增强采集画面的亮度。
算法对采集到的画面亮度进行增强
  • 手动控制:开发者自主控制算法开关。
  • 智能控制:根据画面光照情况,智能开启或关闭算法。

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

1 设置低照度增强模式

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

枚举值 说明
ZegoLowlightEnhancementModeOff 关闭低照度增强功能。
ZegoLowlightEnhancementModeOn 开启低照度增强功能,由开发者自主控制。
ZegoLowlightEnhancementModeAuto 智能控制低照度增强功能,根据画面光照情况,智能开启或关闭功能。

低照度增强类型 ZegoExpLowlightEnhancementType 包括如下类型:

枚举值 说明
ZegoExpLowlightEnhancementTypeNormal 常规低照度增强。
ZegoExpLowlightEnhancementTypeAI AI 低照度增强。如需要使用此功能,需要联系 ZEGO 技术支持。

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

ZegoExpLowlightEnhancementParams *params = [[ZegoExpLowlightEnhancementParams alloc] init];
params.mode = ZegoLowlightEnhancementModeAuto;
params.type = ZegoExpLowlightEnhancementTypeAI;
[[ZegoExpressEngine sharedEngine] setLowlightEnhancementParams:params channel:ZegoPublishChannelMain];

2 (可选)开启摄像头自适应帧率

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

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

调用 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 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];//开启色彩增强

3 开始预览

调用 startPreview 接口开启预览后,可以设置不同的视频增强功能,并实时体验效果。

ZegoCanvas *previewCanvas = [ZegoCanvas canvasWithView:preview];
[[ZegoExpressEngine sharedEngine] startPreview:previewCanvas];

4 开始推流

当预览效果达到预期后,可以调用 startPublishingStream 接口开始推流,推流画面效果将与预览效果一致。

[[ZegoExpressEngine sharedEngine] startPublishingStream:@"STREAM_ID"];

以上,即可实现推流前视频增强功能。

本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈