Improve your appearance in the video

Introduction

ZEGOCLOUD’s SDKs provide basic face beautification features such as skin tone enhancement, skin smoothing, cheek blusher, and image sharpening, which are commonly used in video calls and live streaming scenarios, making you look the way you want.

You can enable the basic face beautification features based on your needs and set the intensity as wanted.

Prerequisites

Before you begin, make sure:

• ZEGO Express SDK has been integrated into the project to implement basic real-time audio and video functions. For details, please refer to Quick start .
• A project has been created in ZEGOCLOUD Console and applied for a valid AppID and AppSign. For details, please refer to Console - Project Information .

Initialize the face beautification environment

To use the basic face beautification features, call the startEffectsEnv method to initialize the face beautification environment before starting the local video view (startPreview) and publishing streams (startPublishingStream).

After initializing the face beautification environment, the SDK implements the transmission with the default video frame data type. If you need to use the custom video pre-processing feature, you will need to configure the corresponding video frame data type:

• Windows: Only supports the raw type data. That is, you must set the bufferType of the ZegoCustomVideoCaptureConfig to ZEGO_VIDEO_BUFFER_TYPE_RAW_DATA.
• iOS and macOS: Only supports the data of CVPixelBuffer type. That is, you must set the bufferType of the ZegoCustomVideoCaptureConfig to ZegoVideoBufferTypeCVPixelBuffer.
• Android: Only supports the data of Texture 2D type. That is, you must set the bufferType of the ZegoCustomVideoCaptureConfig to GL_TEXTURE_2D.

/** Create a face beautification environment */
[[ZegoExpressEngine sharedInstance] startEffectsEnv];

Enable the basic face beautification features

After initializing the face beautification environment, you can call the enableEffectsBeauty method to enable the face beautification feature you want to use after or before the stream publishing.

/** Enable the basic face beautification features */
[[ZegoExpressEngine sharedInstance] enableEffectsBeauty:true];

Set the intensity for the face beautification features

After initializing the face beautification environment, you can call the setEffectsBeautyParam method to set the intensity as needed after or before the stream publishing.

• smoothIntensity: Skin smoothing. Smooth the skin while preserving details of the face, such as moles.
• whitenIntensity: Skin tone enhancement. Turn up the overall brightness to whiten your face.
• rosyIntensity: Cheek blusher. Carry on the warm color processing to the whole picture.
• sharpenIntensity: Image sharpening. You can sharpen it slightly to make it clearer when the picture is a little blurry.

The value range for the four features is [0, 100], and the default value is 50. As this value gets larger, the intensity gets stronger.

// Create a parameter object for the face beautification environment.
ZegoEffectsBeautyParam *beautyParam = [[ZegoEffectsBeautyParam alloc] init];

// Skin tone enhancement, cheek blusher, skin smoothing, image sharpening
beautyParam.whitenIntensity = 50;
beautyParam.rosyIntensity = 50;
beautyParam.smoothIntensity = 50;
beautyParam.sharpenIntensity = 50;

/** Set the intensity by specifying the parameter */
[[ZegoExpressEngine sharedInstance] setEffectsBeautyParam:beautyParam];

Destroy the face beautification environment

To disable the face beautification features, set the parameter to false when calling the enableEffectsBeauty method. While the face beautification module still occupies resources.

To destroy the face beautification environment and release the resources it occupies, call the stopEffectsEnv method before the local video preview and stream publishing.

/** Destroy the face beautification environment  */
[[ZegoExpressEngine sharedInstance] stopEffectsEnv];