getFaceShapeBeautyOptions

Gets the beauty effect options.

virtual int getFaceShapeBeautyOptions(FaceShapeBeautyOptions& options, agora::media::MEDIA_SOURCE_TYPE type = agora::media::PRIMARY_CAMERA_SOURCE) = 0;
Since
v4.5.0

Calling this method can retrieve the current settings of the beauty effect.

Applicable scenarios

When the user opens the beauty style and style intensity menu in the app, you can call this method to get the current beauty effect options, then refresh the menu in the user interface according to the results, and update the UI.

Call timing

Call this method after calling enableVideo.

Restrictions

None.

Parameters

options
Face shaping style options, see FaceShapeBeautyOptions.
type
The type of the media source to which the filter effect is applied. See MEDIA_SOURCE_TYPE.
Attention: In this method, this parameter supports only the following two settings:
  • Use the default value PRIMARY_CAMERA_SOURCE if you use camera to capture local video.
  • Set this parameter to CUSTOM_VIDEO_SOURCE if you use custom video source.

Returns

  • 0: Success.
  • < 0: Failure.