setFaceShapeAreaOptions [2/2]

Sets the options for beauty enhancement facial areas.

public abstract int setFaceShapeAreaOptions(FaceShapeAreaOptions options);
Since
v4.5.0

If the preset beauty effects implemented in the setFaceShapeBeautyOptions [1/2] method do not meet expectations, you can use this method to set beauty area options, individually fine-tune each part of the face, and achieve a more refined beauty effect.

Call timing

Call this method after calling setFaceShapeBeautyOptions [1/2] or setFaceShapeBeautyOptions [1/2].

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

options
Facial enhancement areas, see FaceShapeAreaOptions.

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.