ZEGO Express SDK 提供多种视频前处理增强能力,开发者可以根据业务需要,在推流端对画面的效果进行调整。
功能 | 功能描述 | 功能优势 | 效果展示 | |
---|---|---|---|---|
基础美颜 |
根据用户和业务需要,调整美白、磨皮、锐化以及红润的程度,轻松实现基础美颜功能,为用户呈现出良好的肌肤状态,打造独特自然的美颜效果。 |
覆盖高频使用的美颜能力。 |
||
低照度增强 |
在环境光较暗的情况下,摄像头采集到的画面亮度不满足看清人脸、或无法进行人脸识别等业务需求时,对画面亮度进行增强。 |
|
||
色彩增强 |
由于摄像头的特性,采集到的视频可能存在饱和度不足的问题。使用色彩增强功能,在保护人物肤色的情况下,增强欠饱和的色彩,让画面色彩更逼真,更符合人的视觉感受。 |
|
在使用推流视频增强功能前,请确保:
初始化和登录房间的具体流程,请参考实现视频通话文档中的 “创建引擎” 及 “登录房间”。
请根据需要,选择对应的功能进行配置。
此功能为 ZEGO Express SDK 内置 ZEGO Effects SDK 的基础美颜功能,仅包含美白、红润、磨皮、锐化四种美颜效果。如需使用更多进阶的美颜功能,请参考 实时音视频和 AI 美颜的搭配使用。
若您需要使用基础美颜功能,则必须在 startPreview 开始预览、startPublishingStream 推流前,调用 startEffectsEnv 接口初始化美颜环境。
// 创建美颜环境
ZegoExpressEngine.getEngine().startEffectsEnv();
当初始化美颜环境后,SDK 内部会使用固定的视频帧数据类型进行传输,如果您使用基础美颜功能时还需要使用到视频自定义前处理,则只能配置相对应的视频帧数据类型:
Android 平台:只支持 Texture 2D 类型的数据,即 ZegoCustomVideoCaptureConfig 的 bufferType 取值为 “GL_TEXTURE_2D”。
enableEffectsBeauty 接口和 setEffectsBeautyParam 接口的调用时序无先后之分。
初始化美颜环境后,您可以在推流前后,调用 enableEffectsBeauty 接口实时开启或关闭美颜效果。
// 开关美颜效果
ZegoExpressEngine.getEngine().enableEffectsBeauty(true);
初始化美颜环境后,您可以在推流前后,调用 setEffectsBeautyParam 接口实时设置美颜效果参数。
以上四个参数的取值范围都为 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] 之间动态调整,以延长每一帧的曝光时间增强采集画面的亮度。 |
算法对采集到的画面亮度进行增强 |
|
两种处理方式可以独立使用,也可以同时使用,均兼容美颜功能。
RTC SDK 支持不同的算法低照度增强模式,调用 setLowlightEnhancement 接口进行设置低照度增强模式 ZegoLowlightEnhancementMode:
枚举值 | 说明 |
---|---|
ZegoLowlightEnhancementMode.OFF | 关闭低照度增强功能,采集画面亮度不变。 |
ZegoLowlightEnhancementMode.ON | 开启低照度增强功能,采集画面亮度增强。 |
ZegoLowlightEnhancementMode.AUTO | 自动低照度增强功能,采集画面亮度增强值随环境亮度动态调整。 |
以开启自动低照度增强功能为例:
engine.setLowlightEnhancement(ZegoLowlightEnhancementMode.AUTO,ZegoPublishChannel.MAIN);
当环境光照度较低,且摄像头采集帧率过高时,每一帧画面的曝光时间不足,可能导致采集的视频画面偏暗,此时可以通过 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);//开启色彩增强
调用 startPreview 接口开启预览后,可以设置不同的视频增强功能,并实时体验效果。
ZegoCanvas previewCanvas = new ZegoCanvas(preview);
engine.startPreview(previewCanvas);
当预览效果达到预期后,可以调用 startPublishingStream 接口开始推流,推流画面效果将与预览效果一致。
engine.startPublishingStream("STREAM_ID");
以上,即可实现推流前视频增强功能。
联系我们
文档反馈