# 高级美颜（旧版） (/zh-CN/realtime-media/rtc/build/video/advanced-beauty-legacy)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<_PlatformTabsGroup>
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" />
:::info[信息]
本文介绍如何实现美型和美妆两种高级美颜功能。本文适用于 v4.5.x 版本的 SDK。如果你的 SDK 版本 v4.6.0 及以上，请参考[高级美颜](/zh-CN/realtime-media/rtc/build/video/advanced-beauty)了解如何使用美颜 2.0。
:::

## 功能介绍 [#功能介绍]

SDK 提供 [`setBeautyEffectOptions`](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_setbeautyeffectoptions) 方法，用于实现美白、磨皮等基础美颜功能。

自 v4.5.0 起，SDK 提供以下高级美颜功能：

- 美型：对人脸各部位进行修饰（即捏脸），使用预设的模板一次性实现瘦脸、大眼、瘦鼻等微整形效果，也支持对人脸的各个部位单独微调，实现更加精细的美型效果。
- 美妆：实现眼影、美瞳、睫毛、美眉、唇彩、腮红等美妆特效。

:::info[信息]
当前，高级美颜为限时免费。未来可能会变更为单独计费的增值服务，届时请以实际计费为准，详见[计费说明](/zh-CN/realtime-media/rtc/reference/billing-strategy)。
:::

## 前提条件 [#前提条件]

在实现高级美颜之前，请确保：

- 已集成实时互动 SDK v4.5.0 及以上版本。
- 已在 App 中实现了基本的实时音视频功能，且 App 已获取相关设备的使用权限。请参考[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- SDK 已集成视频增强动态库，如果删除该动态库会导致无法正常开启高级美颜。动态库名和集成方式详见[插件列表](/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size#插件列表)。
- 如需使用美妆功能，请[联系技术支持](https://ticket.shengwang.cn/)获取美妆资源。

## 实现高级美颜 [#实现高级美颜]

### 美型 [#美型]

#### 实现预设美型效果 [#实现预设美型效果]

`setFaceShapeBeautyOptions` 方法为美型效果的总开关，调用该方法，并在 `enable` 参数中传入 `true` 即可开启美型效果。你可以在 `FaceShapeBeautyOptions` 中指定美型风格和风格强度，使用预设的参数快速实现美型效果。

```java
import io.agora.rtc2.video.FaceShapeBeautyOptions;

FaceShapeBeautyOptions beautyOptions = new FaceShapeBeautyOptions();
// 设置美型风格类型为男性
beautyOptions.shapeStyle = FaceShapeBeautyOptions.FACE_SHAPE_BEAUTY_STYLE_MALE;
// 设置风格强度
beautyOptions.styleIntensity = 100;
mRtcEngine.setFaceShapeBeautyOptions(true, beautyOptions);
```

#### 微调单个部位 [#微调单个部位]

开启美型后，调用 `setFaceShapeAreaOptions` 方法可对人脸的各个部位单独微调。该方法对单个部位修饰力度的调整为立即生效，不会修改预设值。

```java
import io.agora.rtc2.video.FaceShapeAreaOptions;

FaceShapeAreaOptions areaOptions = new FaceShapeAreaOptions();
// 指定一个微调的部位，比如：头部尺寸
areaOptions.shapeArea = FaceShapeAreaOptions.FACE_SHAPE_AREA_HEADSCALE;
// 该部位调整的强度
areaOptions.shapeIntensity = 100;
mRtcEngine.setFaceShapeAreaOptions(areaOptions);
```

#### 关闭美型 [#关闭美型]

调用 `setFaceShapeEffectOptions` 方法，并在 `enable` 参数中传入 `false` 即可关闭美型效果。

```java
mRtcEngine.setFaceShapeBeautyOptions(false, beautyOptions)
```

### 美妆 [#美妆]

#### 开启美妆 [#开启美妆]

调用 `setExtensionProperty` 方法开启美妆效果，参考以下说明填写参数：

- `provider`：`agora_video_filters_clear_vision`
- `extension`：`clear_vision`
- `key`：`makeup_options`
- `value`：以 JSON 格式包装，其中不同的字段对应了不同的美妆效果，详见[美妆 JSON 字段说明](#美妆-json-字段说明)。
- `sourceType`：仅支持以下设置：
    - 使用摄像头采集时，保持默认的 `PRIMARY_CAMERA_SOURCE`。
    - 自采集场景下，设为 `CUSTOM_VIDEO_SOURCE`。

参考以下代码开启美妆效果：

```java
// 创建一个用于配置美妆效果的 JSON
public class MpOptions {
    public static final String TAG = "MpOptions";
    public boolean enable_mu;
    public int browStyle;
    public int browColor;
    public float browStrength;
    public int lashStyle;
    public int lashColor;
    public float lashStrength;
    public int shadowStyle;
    public float shadowStrength;
    public int pupilStyle;
    public float pupilStrength;
    public int blushStyle;
    public int blushColor;
    public float blushStrength;
    public int lipStyle;
    public int lipColor;
    public float lipStrength;

    public MpOptions() {
        this.enable_mu = false;
        this.browStyle = 0;
        this.browColor = 0;
        this.browStrength = 0.5f;
        this.lashStyle = 0;
        this.lashColor = 0;
        this.lashStrength = 0.5f;
        this.shadowStyle = 0;
        this.shadowStrength = 0.5f;
        this.pupilStyle = 0;
        this.pupilStrength = 0.5f;
        this.blushStyle = 0;
        this.blushColor = 0;
        this.blushStrength = 0.5f;
        this.lipStyle = 0;
        this.lipColor = 0;
        this.lipStrength = 0.5f;
    }

    public String toJson() {
        String json = "{}";
        JSONObject jsonObject = new JSONObject();

        try {
            Field[] fields = MpOptions.class.getDeclaredFields();
            for (Field field : fields) {
                field.setAccessible(true);
                String name = field.getName();
                Object value = field.get(this);
                jsonObject.put(name, value);
            }
        } catch (Exception e) {
            Log.e(TAG, "toJson: error:" + e.getMessage());
        }
        json = jsonObject.toString();
        Log.d(TAG, "toJson: " + json);
        return json;
    }
}

// 设置美妆效果选项
MpOptions makeUpOptions = new MpOptions();
makeUpOptions.enable_mu = true;
makeUpOptions.lashStyle = 1;
makeUpOptions.lashColor = 2;
makeUpOptions.lashStrength = 0.5f;
// 开启美妆效果
mRtcEngine.setExtensionProperty("agora_video_filters_clear_vision", "clear_vision", "makeup_options", makeUpOptions.toJson(), Constants.MediaSourceType.PRIMARY_CAMERA_SOURCE);
```

#### 修改美妆效果选项 [#修改美妆效果选项]

修改 JSON 中美妆效果字段的值后调用 `setExtensionProperty` 方法，即可修改美妆效果选项。参考以下代码修改美妆效果：

```java
MpOptions makeUpOptions = new MpOptions();
// 修改眉毛修饰力度
makeUpOptions.lashStrength = 0.8f;
mRtcEngine.setExtensionProperty("agora_video_filters_clear_vision", "clear_vision", "makeup_options", makeUpOptions.toJson(), Constants.MediaSourceType.PRIMARY_CAMERA_SOURCE);
```

#### 关闭美妆效果 [#关闭美妆效果]

在 JSON 中指定 `enable_mu` 节点为 `false`，再调用 `setExtensionProperty` 方法即可关闭美妆效果：

```java
MpOptions makeUpOptions = new MpOptions();
makeUpOptions.enable_mu = false;
mRtcEngine.setExtensionProperty("agora_video_filters_clear_vision", "clear_vision", "makeup_options", makeUpOptions.toJson(), Constants.MediaSourceType.PRIMARY_CAMERA_SOURCE);
```

## 参考信息 [#参考信息]

### 示例项目 [#示例项目]

声网提供了开源的实现高级美颜示例项目供你参考，你可以前往下载或查看其中的源代码。

<Cards>
  <Card title={<RepositoryCardTitle provider="gitee">VideoProcessExtension</RepositoryCardTitle>} href="https://gitee.com/agoraio-community/API-Examples/blob/main/Android/APIExample/app/src/main/java/io/agora/api/example/examples/advanced/VideoProcessExtension.java" />
  <Card title={<RepositoryCardTitle provider="github">VideoProcessExtension</RepositoryCardTitle>} href="https://github.com/Shengwang-Community/API-Examples/blob/main/Android/APIExample/app/src/main/java/io/agora/api/example/examples/advanced/VideoProcessExtension.java" />
</Cards>

### API 参考 [#api-参考]

#### 美型 [#美型-1]

- [`setFaceShapeBeautyOptions`[1/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapebeautyoptions)
- [`setFaceShapeBeautyOptions`[2/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapebeautyoptions2)
- [`setFaceShapeAreaOptions`[1/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapeareaoptions)
- [`setFaceShapeAreaOptions`[2/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapeareaoptions2)
- [`getFaceShapeBeautyOptions`[1/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapebeautyoptions)
- [`getFaceShapeBeautyOptions`[2/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapebeautyoptions2)
- [`getFaceShapeAreaOptions`[1/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapeareaoptions)
- [`getFaceShapeAreaOptions`[2/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapeareaoptions2)

#### 美妆 [#美妆-1]

- [`setExtensionProperty`](/zh-CN/api-reference/rtc/android/extension#api_irtcengine_setextensionproperty)

### 美妆 JSON 字段说明 [#美妆-json-字段说明]

实现美妆效果的 JSON 示例和具体字段说明如下：

```json
{
    "enable_mu": true,
    "browStyle": 1,
    "browColor": 2,
    "browStrength": 0.5,
    "lashStyle": 1,
    "lashColor": 2,
    "lashStrength": 0.5,
    "shadowStyle": 2,
    "shadowStrength": 0.5,
    "pupilStyle": 2,
    "pupilStrength": 0.5,
    "blushStyle": 1,
    "blushColor": 1,
    "blushStrength": 0.5,
    "lipStyle": 2,
    "lipColor": 2,
    "lipStrength": 0.5
}
```

- `enable_mu`：Boolean。美妆开关。设置为：
  - `true`：开启美妆效果。
  - `false`：关闭美妆效果。
- `browStyle`：Integer。眉毛类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `browColor`：Integer。眉毛颜色，可选值为：
  - `0`：无。
  - `1`：黑色。
  - `2`：棕色。
- `browStrength`：Float。眉毛强度，取值范围为 [0.0, 1.0]，其中：
  - `0.0`：无强度。
  - `1.0`：最大强度。
- `lashStyle`：Integer。眼睫毛类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `lashColor`：Integer。眼睫毛颜色，可选值为：
  - `0`：无。
  - `1`：黑色。
  - `2`：棕色。
- `lashStrength`：Float。眼睫毛强度，取值范围为 [0.0, 1.0]。
- `shadowStyle`：Integer。眼影类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `shadowStrength`：Float。眼影强度，取值范围为 [0.0, 1.0]。
- `pupilStyle`：Integer。瞳孔类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `pupilStrength`：Float。瞳孔强度，取值范围为 [0.0, 1.0]。
- `blushStyle`：Integer。腮红类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `blushColor`：Integer。腮红颜色，可选值为：
  - `0`：无。
  - `1`：1号色。
  - `2`：2号色。
  - `3`：3号色。
  - `4`：4号色。
  - `5`：5号色。
- `blushStrength`：Float。腮红强度，取值范围为 [0.0, 1.0]。
- `lipStyle`：Integer。唇彩类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `lipColor`：Integer。唇彩颜色，可选值为：
  - `0`：无。
  - `1`：1号色。
  - `2`：2号色。
  - `3`：3号色。
  - `4`：4号色。
  - `5`：5号色。
- `lipStrength`：Float。唇彩强度，取值范围为 [0.0, 1.0]。
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" />
本文介绍如何实现美型和美妆两种高级美颜功能。
:::info[信息]
本文适用于 v4.5.x 版本的 SDK。如果你的 SDK 版本 v4.6.0 及以上，请参考[高级美颜](/zh-CN/realtime-media/rtc/build/video/advanced-beauty)了解如何使用美颜 2.0。
:::

## 功能介绍 [#功能介绍-1]

SDK 提供 [`setBeautyEffectOptions`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_setbeautyeffectoptions) 方法，用于实现美白、磨皮等基础美颜功能。

自 v4.5.0 起，SDK 提供以下高级美颜功能：

- 美型：对人脸各部位进行修饰（即捏脸），使用预设的模板一次性实现瘦脸、大眼、瘦鼻等微整形效果，也支持对人脸的各个部位单独微调，实现更加精细的美型效果。
- 美妆：实现眼影、美瞳、睫毛、美眉、唇彩、腮红等美妆特效。

:::info[信息]
当前，高级美颜为限时免费。未来可能会变更为单独计费的增值服务，届时请以实际计费为准，详见[计费说明](/zh-CN/realtime-media/rtc/reference/billing-strategy)。
:::

## 前提条件 [#前提条件-1]

在实现高级美颜之前，请确保：

- 已集成实时互动 SDK v4.5.0 及以上版本。
- 已在 App 中实现了基本的实时音视频功能，且 App 已获取相关设备的使用权限。请参考[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- SDK 已集成视频增强动态库，如果删除该动态库会导致无法正常开启高级美颜。动态库名和集成方式详见[插件列表](/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size#插件列表)。
- 如需使用美妆功能，请[联系技术支持](https://ticket.shengwang.cn/)获取美妆资源。

## 实现高级美颜 [#实现高级美颜-1]

### 美型 [#美型-2]

#### 实现预设美型效果 [#实现预设美型效果-1]

`setFaceShapeBeautyOptions:options:` 方法为美型效果的总开关，调用该方法，并在 `enable` 参数中传入 `true` 即可开启美型效果。你可以在 `FaceShapeBeautyOptions` 中指定美型风格和风格强度，使用预设的参数快速实现美型效果。

```swift
var beautyOptions = AgoraFaceShapeBeautyOptions()
// 设置美型风格类型为男性
beautyOptions.shapeStyle = AgoraFaceShapeStyle.male
// 设置风格强度
beautyOptions.styleIntensity = 100
agoraKit?.setFaceShapeBeautyOptions(true, options: beautyOptions)
```

#### 微调单个部位 [#微调单个部位-1]

开启美型后，调用 `setFaceShapeAreaOptions:` 方法可对人脸的各个部位单独微调。该方法对单个部位修饰力度的调整为立即生效，不会修改预设值。

```swift
var areaOptions = AgoraFaceShapeAreaOptions()
// 指定一个微调的部位，比如：头部尺寸
areaOptions.shapeArea = AgoraFaceShapeArea.headScale
// 该部位调整的强度
areaOptions.shapeIntensity = 100
agoraKit?.setFaceShapeAreaOptions(areaOptions)
```

#### 关闭美型 [#关闭美型-1]

调用 `setFaceShapeBeautyOptions:options:` 方法，并在 `enable` 参数中传入 `false` 即可关闭美型效果。

```swift
agoraKit?.setFaceShapeBeautyOptions(false, options: beautyOptions)
```

### 美妆 [#美妆-2]

#### 开启美妆 [#开启美妆-1]

调用 `setExtensionPropertyWithVendor:extension:key:value:` 方法开启美妆效果，参考以下说明填写参数：

- `provider`：`agora_video_filters_clear_vision`
- `extension`：`clear_vision`
- `key`：`makeup_options`
- `value`：以 JSON 格式包装，其中不同的字段对应了不同的美妆效果，详见[美妆 JSON 字段说明](#美妆-json-字段说明-1)。

参考以下代码开启美妆效果：

```swift
let makeupParams: [String: Any] = [
   "enable_mu": true,
   "blushStyle": 1,
   "blushColor": 2,
   "blushStrength": 0.5
]
guard let json = try? JSONSerialization.data(withJSONObject: makeupParams, options: []),
   let jsonString = String(data: json, encoding: .utf8) else {
   return
}

self.agoraKit.setExtensionPropertyWithVendor("agora_video_filters_clear_vision",
                                              extension: "clear_vision",
                                              key: "makeup_options",
                                              value: jsonString)
```

#### 修改美妆效果选项 [#修改美妆效果选项-1]

修改 JSON 中美妆效果字段的值后调用 `setExtensionPropertyWithVendor:extension:key:value:` 方法，即可修改美型效果选项。参考以下代码修改美妆效果：

```swift
let makeupParams: [String: Any] = [
   "blushColor": 1,
]
guard let json = try? JSONSerialization.data(withJSONObject: makeupParams, options: []),
   let jsonString = String(data: json, encoding: .utf8) else {
   return
}

self.agoraKit.setExtensionPropertyWithVendor("agora_video_filters_clear_vision",
                                              extension: "clear_vision",
                                              key: "makeup_options",
                                              value: jsonString)
```

#### 关闭美妆效果 [#关闭美妆效果-1]

在 JSON 中指定 `enable_mu` 节点为 `false`，再调用 `setExtensionPropertyWithVendor:extension:key:value:` 方法即可关闭美妆效果：

```swift
let makeupParams: [String: Any] = [
   "enable_mu": false,
]
guard let json = try? JSONSerialization.data(withJSONObject: makeupParams, options: []),
   let jsonString = String(data: json, encoding: .utf8) else {
   return
}

self.agoraKit.setExtensionPropertyWithVendor("agora_video_filters_clear_vision",
                                              extension: "clear_vision",
                                              key: "makeup_options",
                                              value: jsonString)
```

## 参考信息 [#参考信息-1]

### 示例项目 [#示例项目-1]

声网提供了开源的实现高级美颜示例项目供你参考，你可以前往下载或查看其中的源代码。

<Cards>
  <Card title={<RepositoryCardTitle provider="gitee">VideoProcess</RepositoryCardTitle>} href="https://gitee.com/agoraio-community/API-Examples/tree/main/iOS/APIExample/APIExample/Examples/Advanced/VideoProcess/VideoProcess.swift" />
  <Card title={<RepositoryCardTitle provider="github">VideoProcess</RepositoryCardTitle>} href="https://github.com/Shengwang-Community/API-Examples/tree/main/iOS/APIExample/APIExample/Examples/Advanced/VideoProcess/VideoProcess.swift" />
</Cards>

### API 参考 [#api-参考-1]

#### 美型 [#美型-3]

- [`setFaceShapeBeautyOptions:options:`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapebeautyoptions)
- [`setFaceShapeBeautyOptions:options:sourceType:`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapebeautyoptions2)
- [`setFaceShapeAreaOptions:`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapeareaoptions)
- [`setFaceShapeAreaOptions:sourceType:`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapeareaoptions2)
- [`getFaceShapeBeautyOptions`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapebeautyoptions)
- [`getFaceShapeBeautyOptions:sourceType:`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapebeautyoptions2)
- [`getFaceShapeAreaOptions:`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapeareaoptions)
- [`getFaceShapeAreaOptions:sourceType:`](/zh-CN/api-reference/rtc/ios/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapeareaoptions2)

#### 美妆 [#美妆-3]

- [`setExtensionPropertyWithVendor:extension:key:value:`](/zh-CN/api-reference/rtc/ios/extension#api_irtcengine_setextensionproperty)

### 美妆 JSON 字段说明 [#美妆-json-字段说明-1]

实现美妆效果的 JSON 示例和具体字段说明如下：

```json
{
    "enable_mu": true,
    "browStyle": 1,
    "browColor": 2,
    "browStrength": 0.5,
    "lashStyle": 1,
    "lashColor": 2,
    "lashStrength": 0.5,
    "shadowStyle": 2,
    "shadowStrength": 0.5,
    "pupilStyle": 2,
    "pupilStrength": 0.5,
    "blushStyle": 1,
    "blushColor": 1,
    "blushStrength": 0.5,
    "lipStyle": 2,
    "lipColor": 2,
    "lipStrength": 0.5
}
```

- `enable_mu`：Boolean。美妆开关。设置为：
  - `true`：开启美妆效果。
  - `false`：关闭美妆效果。
- `browStyle`：Integer。眉毛类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `browColor`：Integer。眉毛颜色，可选值为：
  - `0`：无。
  - `1`：黑色。
  - `2`：棕色。
- `browStrength`：Float。眉毛强度，取值范围为 [0.0, 1.0]，其中：
  - `0.0`：无强度。
  - `1.0`：最大强度。
- `lashStyle`：Integer。眼睫毛类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `lashColor`：Integer。眼睫毛颜色，可选值为：
  - `0`：无。
  - `1`：黑色。
  - `2`：棕色。
- `lashStrength`：Float。眼睫毛强度，取值范围为 [0.0, 1.0]。
- `shadowStyle`：Integer。眼影类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `shadowStrength`：Float。眼影强度，取值范围为 [0.0, 1.0]。
- `pupilStyle`：Integer。瞳孔类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `pupilStrength`：Float。瞳孔强度，取值范围为 [0.0, 1.0]。
- `blushStyle`：Integer。腮红类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `blushColor`：Integer。腮红颜色，可选值为：
  - `0`：无。
  - `1`：1号色。
  - `2`：2号色。
  - `3`：3号色。
  - `4`：4号色。
  - `5`：5号色。
- `blushStrength`：Float。腮红强度，取值范围为 [0.0, 1.0]。
- `lipStyle`：Integer。唇彩类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `lipColor`：Integer。唇彩颜色，可选值为：
  - `0`：无。
  - `1`：1号色。
  - `2`：2号色。
  - `3`：3号色。
  - `4`：4号色。
  - `5`：5号色。
- `lipStrength`：Float。唇彩强度，取值范围为 [0.0, 1.0]。
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="macos" />
本文介绍如何实现美型和美妆两种高级美颜功能。
:::info[信息]
本文适用于 v4.5.x 版本的 SDK。如果你的 SDK 版本 v4.6.0 及以上，请参考[高级美颜](/zh-CN/realtime-media/rtc/build/video/advanced-beauty)了解如何使用美颜 2.0。
:::

## 功能介绍 [#功能介绍-2]

SDK 提供 [`setBeautyEffectOptions`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_setbeautyeffectoptions) 方法，用于实现美白、磨皮等基础美颜功能。

自 v4.5.0 起，SDK 提供以下高级美颜功能：

- 美型：对人脸各部位进行修饰（即捏脸），使用预设的模板一次性实现瘦脸、大眼、瘦鼻等微整形效果，也支持对人脸的各个部位单独微调，实现更加精细的美型效果。
- 美妆：实现眼影、美瞳、睫毛、美眉、唇彩、腮红等美妆特效。

:::info[信息]
当前，高级美颜为限时免费。未来可能会变更为单独计费的增值服务，届时请以实际计费为准，详见[计费说明](/zh-CN/realtime-media/rtc/reference/billing-strategy)。
:::

## 前提条件 [#前提条件-2]

在实现高级美颜之前，请确保：

- 已集成实时互动 SDK v4.5.0 及以上版本。
- 已在 App 中实现了基本的实时音视频功能，且 App 已获取相关设备的使用权限。请参考[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- SDK 已集成视频增强动态库，如果删除该动态库会导致无法正常开启高级美颜。动态库名和集成方式详见[插件列表](/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size#插件列表)。
- 如需使用美妆功能，请[联系技术支持](https://ticket.shengwang.cn/)获取美妆资源。

## 实现高级美颜 [#实现高级美颜-2]

### 美型 [#美型-4]

#### 实现预设美型效果 [#实现预设美型效果-2]

`setFaceShapeBeautyOptions:options:` 方法为美型效果的总开关，调用该方法，并在 `enable` 参数中传入 `true` 即可开启美型效果。你可以在 `FaceShapeBeautyOptions` 中指定美型风格和风格强度，使用预设的参数快速实现美型效果。

```swift
var beautyOptions = AgoraFaceShapeBeautyOptions()
// 设置美型风格类型为男性
beautyOptions.shapeStyle = AgoraFaceShapeStyle.male
// 设置风格强度
beautyOptions.styleIntensity = 100
agoraKit?.setFaceShapeBeautyOptions(true, options: beautyOptions)
```

#### 微调单个部位 [#微调单个部位-2]

开启美型后，调用 `setFaceShapeAreaOptions:` 方法可对人脸的各个部位单独微调。该方法对单个部位修饰力度的调整为立即生效，不会修改预设值。

```swift
var areaOptions = AgoraFaceShapeAreaOptions()
// 指定一个微调的部位，比如：头部尺寸
areaOptions.shapeArea = AgoraFaceShapeArea.headScale
// 该部位调整的强度
areaOptions.shapeIntensity = 100
agoraKit?.setFaceShapeAreaOptions(areaOptions)
```

#### 关闭美型 [#关闭美型-2]

调用 `setFaceShapeBeautyOptions:options:` 方法，并在 `enable` 参数中传入 `false` 即可关闭美型效果。

```swift
agoraKit?.setFaceShapeBeautyOptions(false, options: beautyOptions)
```

### 美妆 [#美妆-4]

#### 开启美妆 [#开启美妆-2]

调用 `setExtensionPropertyWithVendor:extension:key:value:` 方法开启美妆效果，参考以下说明填写参数：

- `provider`：`agora_video_filters_clear_vision`
- `extension`：`clear_vision`
- `key`：`makeup_options`
- `value`：以 JSON 格式包装，其中不同的字段对应了不同的美妆效果，详见[美妆 JSON 字段说明](#美妆-json-字段说明-2)。

参考以下代码开启美妆效果：

```swift
let makeupParams: [String: Any] = [
   "enable_mu": true,
   "blushStyle": 1,
   "blushColor": 2,
   "blushStrength": 0.5
]
guard let json = try? JSONSerialization.data(withJSONObject: makeupParams, options: []),
   let jsonString = String(data: json, encoding: .utf8) else {
   return
}

self.agoraKit.setExtensionPropertyWithVendor("agora_video_filters_clear_vision",
                                              extension: "clear_vision",
                                              key: "makeup_options",
                                              value: jsonString)
```

#### 修改美妆效果选项 [#修改美妆效果选项-2]

修改 JSON 中美妆效果字段的值后调用 `setExtensionPropertyWithVendor:extension:key:value:` 方法，即可修改美型效果选项。参考以下代码修改美妆效果：

```swift
let makeupParams: [String: Any] = [
   "blushColor": 1,
]
guard let json = try? JSONSerialization.data(withJSONObject: makeupParams, options: []),
   let jsonString = String(data: json, encoding: .utf8) else {
   return
}

self.agoraKit.setExtensionPropertyWithVendor("agora_video_filters_clear_vision",
                                              extension: "clear_vision",
                                              key: "makeup_options",
                                              value: jsonString)
```

#### 关闭美妆效果 [#关闭美妆效果-2]

在 JSON 中指定 `enable_mu` 节点为 `false`，再调用 `setExtensionPropertyWithVendor:extension:key:value:` 方法即可关闭美妆效果：

```swift
let makeupParams: [String: Any] = [
   "enable_mu": false,
]
guard let json = try? JSONSerialization.data(withJSONObject: makeupParams, options: []),
   let jsonString = String(data: json, encoding: .utf8) else {
   return
}

self.agoraKit.setExtensionPropertyWithVendor("agora_video_filters_clear_vision",
                                              extension: "clear_vision",
                                              key: "makeup_options",
                                              value: jsonString)
```

## 参考信息 [#参考信息-2]

### 示例项目 [#示例项目-2]

声网提供了开源的实现高级美颜示例项目供你参考，你可以前往下载或查看其中的源代码。

<Cards>
  <Card title={<RepositoryCardTitle provider="gitee">VideoProcess</RepositoryCardTitle>} href="https://gitee.com/agoraio-community/API-Examples/tree/main/macOS/APIExample/Examples/Advanced/VideoProcess/VideoProcess.swift" />
  <Card title={<RepositoryCardTitle provider="github">VideoProcess</RepositoryCardTitle>} href="https://github.com/Shengwang-Community/API-Examples/tree/main/macOS/APIExample/Examples/Advanced/VideoProcess/VideoProcess.swift" />
</Cards>

### API 参考 [#api-参考-2]

#### 美型 [#美型-5]

- [`setFaceShapeBeautyOptions:options:`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapebeautyoptions)
- [`setFaceShapeBeautyOptions:options:sourceType:`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapebeautyoptions2)
- [`setFaceShapeAreaOptions:`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapeareaoptions)
- [`setFaceShapeAreaOptions:sourceType:`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapeareaoptions2)
- [`getFaceShapeBeautyOptions`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapebeautyoptions)
- [`getFaceShapeBeautyOptions:sourceType:`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapebeautyoptions2)
- [`getFaceShapeAreaOptions:`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapeareaoptions)
- [`getFaceShapeAreaOptions:sourceType:`](/zh-CN/api-reference/rtc/macos/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapeareaoptions2)

#### 美妆 [#美妆-5]

- [`setExtensionPropertyWithVendor:extension:key:value:`](/zh-CN/api-reference/rtc/macos/extension#api_irtcengine_setextensionproperty)

### 美妆 JSON 字段说明 [#美妆-json-字段说明-2]

实现美妆效果的 JSON 示例和具体字段说明如下：

```json
{
    "enable_mu": true,
    "browStyle": 1,
    "browColor": 2,
    "browStrength": 0.5,
    "lashStyle": 1,
    "lashColor": 2,
    "lashStrength": 0.5,
    "shadowStyle": 2,
    "shadowStrength": 0.5,
    "pupilStyle": 2,
    "pupilStrength": 0.5,
    "blushStyle": 1,
    "blushColor": 1,
    "blushStrength": 0.5,
    "lipStyle": 2,
    "lipColor": 2,
    "lipStrength": 0.5
}
```

- `enable_mu`：Boolean。美妆开关。设置为：
  - `true`：开启美妆效果。
  - `false`：关闭美妆效果。
- `browStyle`：Integer。眉毛类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `browColor`：Integer。眉毛颜色，可选值为：
  - `0`：无。
  - `1`：黑色。
  - `2`：棕色。
- `browStrength`：Float。眉毛强度，取值范围为 [0.0, 1.0]，其中：
  - `0.0`：无强度。
  - `1.0`：最大强度。
- `lashStyle`：Integer。眼睫毛类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `lashColor`：Integer。眼睫毛颜色，可选值为：
  - `0`：无。
  - `1`：黑色。
  - `2`：棕色。
- `lashStrength`：Float。眼睫毛强度，取值范围为 [0.0, 1.0]。
- `shadowStyle`：Integer。眼影类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `shadowStrength`：Float。眼影强度，取值范围为 [0.0, 1.0]。
- `pupilStyle`：Integer。瞳孔类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `pupilStrength`：Float。瞳孔强度，取值范围为 [0.0, 1.0]。
- `blushStyle`：Integer。腮红类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `blushColor`：Integer。腮红颜色，可选值为：
  - `0`：无。
  - `1`：1号色。
  - `2`：2号色。
  - `3`：3号色。
  - `4`：4号色。
  - `5`：5号色。
- `blushStrength`：Float。腮红强度，取值范围为 [0.0, 1.0]。
- `lipStyle`：Integer。唇彩类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `lipColor`：Integer。唇彩颜色，可选值为：
  - `0`：无。
  - `1`：1号色。
  - `2`：2号色。
  - `3`：3号色。
  - `4`：4号色。
  - `5`：5号色。
- `lipStrength`：Float。唇彩强度，取值范围为 [0.0, 1.0]。
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="windows" />
本文介绍如何实现美型和美妆两种高级美颜功能。
:::info[信息]
本文适用于 v4.5.x 版本的 SDK。如果你的 SDK 版本 v4.6.0 及以上，请参考[高级美颜](/zh-CN/realtime-media/rtc/build/video/advanced-beauty)了解如何使用美颜 2.0。
:::

## 功能介绍 [#功能介绍-3]

SDK 提供 [`setBeautyEffectOptions`](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-prenpro/video-enhance-option#api_irtcengine_setbeautyeffectoptions) 方法，用于实现美白、磨皮等基础美颜功能。

自 v4.5.0 起，SDK 提供以下高级美颜功能：

- 美型：对人脸各部位进行修饰（即捏脸），使用预设的模板一次性实现瘦脸、大眼、瘦鼻等微整形效果，也支持对人脸的各个部位单独微调，实现更加精细的美型效果。
- 美妆：实现眼影、美瞳、睫毛、美眉、唇彩、腮红等美妆特效。

:::info[信息]
当前，高级美颜为限时免费。未来可能会变更为单独计费的增值服务，届时请以实际计费为准，详见[计费说明](/zh-CN/realtime-media/rtc/reference/billing-strategy)。
:::

## 前提条件 [#前提条件-3]

在实现高级美颜之前，请确保：

- 已集成实时互动 SDK v4.5.0 及以上版本。
- 已在 App 中实现了基本的实时音视频功能，且 App 已获取相关设备的使用权限。请参考[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- SDK 已集成视频增强动态库，如果删除该动态库会导致无法正常开启高级美颜。动态库名和集成方式详见[插件列表](/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size#插件列表)。
- 如需使用美妆功能，请[联系技术支持](https://ticket.shengwang.cn/)获取美妆资源。

## 实现高级美颜 [#实现高级美颜-3]

### 美型 [#美型-6]

#### 实现预设美型效果 [#实现预设美型效果-3]

`setFaceShapeBeautyOptions` 方法为美型效果的总开关，调用该方法，并在 `enable` 参数中传入 `true` 即可开启美型效果。你可以在 `FaceShapeBeautyOptions` 中指定美型风格和风格强度，使用预设的参数快速实现美型效果。

```cpp
agora::rtc::FaceShapeBeautyOptions beauty_options;
// 设置美型风格类型为男性
beauty_options.shapeStyle = agora::rtc::FaceShapeBeautyOptions::FACE_SHAPE_BEAUTY_STYLE_MALE;
// 设置风格强度
beauty_options.styleIntensity = 100;
mRtcEngine->setFaceShapeBeautyOptions(true, beauty_options);
```

#### 微调单个部位 [#微调单个部位-3]

开启美型后，调用 `setFaceShapeAreaOptions` 方法可对人脸的各个部位单独微调。该方法对单个部位修饰力度的调整为立即生效，不会修改预设值。

```cpp
agora::rtc::FaceShapeAreaOptions area_options;
// 指定一个微调的部位，比如：小头
area_options.shapeArea = agora::rtc::FaceShapeAreaOptions::FACE_SHAPE_AREA_HEADSCALE;
// 该部位调整的强度
area_options.shapeIntensity = 100;
mRtcEngine->setFaceShapeAreaOptions(area_options)
```

#### 关闭美型 [#关闭美型-3]

调用 `setFaceShapeEffectOptions` 方法，并在 `enable` 参数中传入 `false` 即可关闭美型效果。

```cpp
mRtcEngine->setFaceShapeBeautyOptions(false, beauty_options);
```

### 美妆 [#美妆-6]

#### 开启美妆 [#开启美妆-3]

调用 `setExtensionProperty` 方法开启美妆效果，参考以下说明填写参数：

- `provider`：`agora_video_filters_clear_vision`
- `extension`：`clear_vision`
- `key`：`makeup_options`
- `value`：以 JSON 格式包装，其中不同的字段对应了不同的美妆效果，详见[美妆 JSON 字段说明](#美妆-json-字段说明-3)。
- `sourceType`：仅支持以下设置：
    - 使用摄像头采集时，保持默认的 `PRIMARY_CAMERA_SOURCE`。
    - 自采集场景下，设为 `CUSTOM_VIDEO_SOURCE`。

参考以下代码开启美妆效果：

```cpp
// 创建一个用于配置美妆效果的 JSON
struct MakeupOptions
{
    bool enable_mu;
    int browStyle;
    int browColor;
    float browStrength;
    int lashStyle;
    int lashColor;
    float lashStrength;
    int shadowStyle;
    float shadowStrength;
    int pupilStyle;
    float pupilStrength;
    int blushStyle;
    int blushColor;
    float blushStrength;
    int lipStyle;
    int lipColor;
    float lipStrength;

    void reset()
    {
        enable_mu = false;
        browStyle = 0;
        browColor = 0;
        browStrength = 0.0f;
        lashStyle = 0;
        lashColor = 0;
        lashStrength = 0.0f;
        shadowStyle = 0;
        shadowStrength = 0.0f;
        pupilStyle = 0;
        pupilStrength = 0.0f;
        blushStyle = 0;
        blushColor = 0;
        blushStrength = 0.0f;
        lipStyle = 0;
        lipColor = 0;
        lipStrength = 0.0f;
    }

    MakeupOptions()
    {
        reset();
    }
    //to json string
    std::string toJsonString()
    {
        std::string jsonStr = "{\"enable_mu\":";
        jsonStr += enable_mu ? "true" : "false";
        jsonStr += ",\"browStyle\":" + std::to_string(browStyle);
        jsonStr += ",\"browColor\":" + std::to_string(browColor);
        jsonStr += ",\"browStrength\":" + std::to_string(browStrength);
        jsonStr += ",\"lashStyle\":" + std::to_string(lashStyle);
        jsonStr += ",\"lashColor\":" + std::to_string(lashColor);
        jsonStr += ",\"lashStrength\":" + std::to_string(lashStrength);
        jsonStr += ",\"shadowStyle\":" + std::to_string(shadowStyle);
        jsonStr += ",\"shadowStrength\":" + std::to_string(shadowStrength);
        jsonStr += ",\"pupilStyle\":" + std::to_string(pupilStyle);
        jsonStr += ",\"pupilStrength\":" + std::to_string(pupilStrength);
        jsonStr += ",\"blushStyle\":" + std::to_string(blushStyle);
        jsonStr += ",\"blushColor\":" + std::to_string(blushColor);
        jsonStr += ",\"blushStrength\":" + std::to_string(blushStrength);
        jsonStr += ",\"lipStyle\":" + std::to_string(lipStyle);
        jsonStr += ",\"lipColor\":" + std::to_string(lipColor);
        jsonStr += ",\"lipStrength\":" + std::to_string(lipStrength);
        jsonStr += "}";
        return jsonStr;
    }
};

// 设置美妆效果
MakeupOptions m_makeupOptions;
m_makeupOptions.enable_mu = true;
m_makeupOptions.browStyle = 1;
m_makeupOptions.browColor = 2;
m_makeupOptions.browStrength = 0.5;

// 转换为 JSON 字符串
std::string str = m_makeupOptions.toJsonString();
// 开启美妆
mRtcEngine->setExtensionProperty("agora_video_filters_clear_vision", "clear_vision", "makeup_options", str.c_str(), PRIMARY_CAMERA_SOURCE);
```

#### 修改美妆效果选项 [#修改美妆效果选项-3]

修改 JSON 中美妆效果字段的值后调用 `setExtensionProperty` 方法，即可修改美妆效果选项。参考以下代码修改美妆效果：

```cpp
MakeupOptions m_makeupOptions;
// 修改眉毛类型
m_makeupOptions.browStyle = 2;
std::string str = m_makeupOptions.toJsonString();
mRtcEngine->setExtensionProperty("agora_video_filters_clear_vision", "clear_vision", "makeup_options", str.c_str(), PRIMARY_CAMERA_SOURCE);
```

#### 关闭美妆效果 [#关闭美妆效果-3]

在 JSON 中指定 `enable_mu` 节点为 `false`，再调用 `setExtensionProperty` 方法即可关闭美妆效果：

```cpp
MakeupOptions m_makeupOptions;
m_makeupOptions.enable_mu = false;
std::string str = m_makeupOptions.toJsonString();
mRtcEngine->setExtensionProperty("agora_video_filters_clear_vision", "clear_vision", "makeup_options", str.c_str(), PRIMARY_CAMERA_SOURCE);
```

## 参考信息 [#参考信息-3]

### 示例项目 [#示例项目-3]

声网提供了开源的实现高级美颜示例项目供你参考，你可以前往下载或查看其中的源代码。

<Cards>
  <Card title={<RepositoryCardTitle provider="gitee">CDlgBeautyEx</RepositoryCardTitle>} href="https://gitee.com/agoraio-community/API-Examples/tree/main/windows/APIExample/APIExample/Advanced/Beauty/CDlgBeautyEx.h" />
  <Card title={<RepositoryCardTitle provider="github">CDlgBeautyEx</RepositoryCardTitle>} href="https://github.com/Shengwang-Community/API-Examples/tree/main/windows/APIExample/APIExample/Advanced/Beauty/CDlgBeautyEx.h" />
</Cards>

### API 参考 [#api-参考-3]

#### 美型 [#美型-7]

- [`setFaceShapeBeautyOptions`](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapebeautyoptions)
- [`setFaceShapeAreaOptions`](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-prenpro/video-enhance-option#api_irtcengine_setfaceshapeareaoptions)
- [`getFaceShapeBeautyOptions`](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapebeautyoptions)
- [`getFaceShapeAreaOptions`](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-prenpro/video-enhance-option#api_irtcengine_getfaceshapeareaoptions)

#### 美妆 [#美妆-7]

- [`setExtensionProperty`](/zh-CN/api-reference/rtc/cpp-all-platforms/extension#api_irtcengine_setextensionproperty)

### 美妆 JSON 字段说明 [#美妆-json-字段说明-3]

实现美妆效果的 JSON 示例和具体字段说明如下：

```json
{
    "enable_mu": true,
    "browStyle": 1,
    "browColor": 2,
    "browStrength": 0.5,
    "lashStyle": 1,
    "lashColor": 2,
    "lashStrength": 0.5,
    "shadowStyle": 2,
    "shadowStrength": 0.5,
    "pupilStyle": 2,
    "pupilStrength": 0.5,
    "blushStyle": 1,
    "blushColor": 1,
    "blushStrength": 0.5,
    "lipStyle": 2,
    "lipColor": 2,
    "lipStrength": 0.5
}
```

- `enable_mu`：Boolean。美妆开关。设置为：
  - `true`：开启美妆效果。
  - `false`：关闭美妆效果。
- `browStyle`：Integer。眉毛类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `browColor`：Integer。眉毛颜色，可选值为：
  - `0`：无。
  - `1`：黑色。
  - `2`：棕色。
- `browStrength`：Float。眉毛强度，取值范围为 [0.0, 1.0]，其中：
  - `0.0`：无强度。
  - `1.0`：最大强度。
- `lashStyle`：Integer。眼睫毛类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `lashColor`：Integer。眼睫毛颜色，可选值为：
  - `0`：无。
  - `1`：黑色。
  - `2`：棕色。
- `lashStrength`：Float。眼睫毛强度，取值范围为 [0.0, 1.0]。
- `shadowStyle`：Integer。眼影类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `shadowStrength`：Float。眼影强度，取值范围为 [0.0, 1.0]。
- `pupilStyle`：Integer。瞳孔类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `pupilStrength`：Float。瞳孔强度，取值范围为 [0.0, 1.0]。
- `blushStyle`：Integer。腮红类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `blushColor`：Integer。腮红颜色，可选值为：
  - `0`：无。
  - `1`：1号色。
  - `2`：2号色。
  - `3`：3号色。
  - `4`：4号色。
  - `5`：5号色。
- `blushStrength`：Float。腮红强度，取值范围为 [0.0, 1.0]。
- `lipStyle`：Integer。唇彩类型，可选值为：
  - `0`：关闭。
  - `1`：类型 1。
  - `2`：类型 2。
- `lipColor`：Integer。唇彩颜色，可选值为：
  - `0`：无。
  - `1`：1号色。
  - `2`：2号色。
  - `3`：3号色。
  - `4`：4号色。
  - `5`：5号色。
- `lipStrength`：Float。唇彩强度，取值范围为 [0.0, 1.0]。
<_PlatformProcessedMarker close="true" />
</_PlatformTabsGroup>