实时音视频
  • iOS
  • Android : Java
  • macOS
  • Windows
  • HarmonyOS
  • Linux
  • Web
  • 小程序
  • Flutter
  • Electron
  • Unreal Engine
  • Unity3D
  • uni-app
  • React Native
  • Cocos Creator
  • 产品简介
  • 下载
  • 体验 App
  • 快速开始
    • 跑通示例源码
    • 集成 SDK
    • 实现视频通话
    • 场景化音视频配置
  • 通信能力
  • 房间能力
  • 音频能力
  • 视频能力
  • 直播能力
  • 其他能力
  • 最佳实践
  • 客户端 API
  • 服务端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • 实时音视频
  • 视频能力
  • 推流视频增强

进阶 - 推流视频增强

更新时间:2024-01-12 15:33

功能简介

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

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

前提条件

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

使用步骤

1 初始化和登录房间

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

2 设置推流视频增强效果

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

基础美颜

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

1 初始化基础美颜环境

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

// 创建美颜环境
ZegoExpressEngine.getEngine().startEffectsEnv();

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

Android 平台:只支持 Texture 2D 类型的数据,即 ZegoCustomVideoCaptureConfigbufferType 取值为 “GL_TEXTURE_2D”。

2 开关基础美颜效果

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

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

// 开关美颜效果
ZegoExpressEngine.getEngine().enableEffectsBeauty(true);

3 设置基础美颜效果参数

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

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

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

// 创建美颜参数对象
ZegoEffectsBeautyParam beautyParam = new ZegoEffectsBeautyParam();

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

// 设置美颜参数
ZegoExpressEngine.getEngine().setEffectsBeautyParam(beautyParam);

(可选)销毁基础美颜环境

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

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

// 销毁美颜环境
ZegoExpressEngine.getEngine().stopEffectsEnv();
低照度增强

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

方式 描述
开启自适应帧率进行增强
在设定的帧率范围内动态降低采集帧率,以延长每一帧的画面曝光时间,达到增强采集到的画面亮度的效果。
例如:开发者开启并设置自适应帧率范围为 [10, 25]。环境光照充足的时候,采集帧率依然是 25 帧,环境光照度较低的时候,采集帧率会在 [10, 25] 之间动态调整,以延长每一帧的曝光时间增强采集画面的亮度。
算法对采集到的画面亮度进行增强
  • 手动增强模式:根据接收到的参数确定是否开启算法增强。
  • 自动增强模式:根据用户所处环境的环境光照度,SDK自动决定是否开启算法增强和增强的程度。

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

1 设置低照度增强模式

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

枚举值 说明
ZegoLowlightEnhancementMode.OFF 关闭低照度增强功能,采集画面亮度不变。
ZegoLowlightEnhancementMode.ON 开启低照度增强功能,采集画面亮度增强。
ZegoLowlightEnhancementMode.AUTO 自动低照度增强功能,采集画面亮度增强值随环境亮度动态调整。

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

engine.setLowlightEnhancement(ZegoLowlightEnhancementMode.AUTO,ZegoPublishChannel.MAIN);

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

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

//设置最小帧率
int minCamFPS = getIntent().getIntExtra("camMinFPS", 0);
//设置最大帧率
int maxCamFPS = getIntent().getIntExtra("camMaxFPS", 0);
engine.enableCameraAdaptiveFPS(true, minCamFPS, maxCamFPS, 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 = new ZegoColorEnhancementParams();
p.intensity = 1;//取值范围:[0,1],取值越大,色彩增强的强度越大。默认值:0。
p.skinToneProtectionLevel = 1;//取值范围:[0,1],取值越大,肤色保护程度越大。默认值:1。
p.lipColorProtectionLevel = 1;//取值范围:[0,1],取值越大,唇色保护程度越大。默认值:0。
engine.enableColorEnhancement(true, p, ZegoPublishChannel.MAIN);//开启色彩增强

3 开始预览

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

ZegoCanvas previewCanvas = new ZegoCanvas(preview);
engine.startPreview(previewCanvas);

4 开始推流

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

engine.startPublishingStream("STREAM_ID");

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

本篇目录