setFaceShapeBeautyOptions [2/2]

Sets the face shape beauty options.

public abstract int setFaceShapeBeautyOptions(boolean enabled, FaceShapeBeautyOptions options);
Since
v4.5.0

Calling this method allows for adjusting specific parts of the face, achieving effects such as slimming the face, enlarging the eyes, and slimming the nose through minor cosmetic procedures.

Call timing

Call this method after calling enableVideo.

Restrictions

  • This method only applies to Android 4.4 or later.
  • This method relies on the image enhancement dynamic library libagora_clear_vision_extension.so. If the dynamic library is deleted, the function cannot be enabled normally.
  • This feature has high requirements on device performance. When calling this method, the SDK automatically checks the capabilities of the current device.

Parameters

enabled
Whether to enable the face shape effect:
  • true: Enable the face shape effect.
  • false: (Default) Disable the face shape effect.
options
Face shaping style options, see FaceShapeBeautyOptions.

Returns

  • 0: Success.
  • < 0: Failure.
    • -4: The current device does not support this feature. Possible reasons include:
      • The current device capabilities do not meet the requirements for image enhancement. Agora recommends you replace it with a high-performance device.
      • The current device version is lower than Android 4.4 and does not support this feature. Agora recommends you replace the device or upgrade the operating system.