getFaceShapeAreaOptions
Gets the facial beauty area options.
virtual int getFaceShapeAreaOptions(agora::rtc::FaceShapeAreaOptions::FACE_SHAPE_AREA shapeArea, FaceShapeAreaOptions& 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 facial beauty area and shaping 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
- shapeArea
-
Facial enhancement areas. See FACE_SHAPE_AREA.
- options
- Facial enhancement areas, see FaceShapeAreaOptions.
- 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.