# 如何使用视频增强插件？ (/zh-CN/reference/faq/integration/video_enhancement)

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

Video SDK v4.x 中提供了视频增强插件，可以实现美颜、暗光增强、色彩增强、视频降噪功能。

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

视频增强插件的主要功能如下：

- **美颜**

  通过调整对比度，美白，磨皮，红润，锐化等参数来实现不同的美颜效果。

- **暗光增强**

  在光线不足、光照不均匀、背光场景下开启暗光增强，可实现智能补光、动态提升画面的整体亮度、改善画面的可视范围和观看质量。

- **色彩增强**

  由于摄像头的多样性，采集到的视频可能存在饱和度不足、画面发灰等问题。开启色彩增强算法，可调整图像和视频画面的饱和度，使画面色彩更加丰富逼真，提升人的视觉主观感受。

  同时，该算法专门提供肤色保护功能，避免人的肤色受到过大影响。

- **视频降噪**

  在采集光线较暗或采集设备较差的场景下开启视频降噪，可消除噪声像素点。

:::warning[注意]
- 视频增强对设备性能有影响，请根据实际场景需求和用户设备性能适度使用视频增强。
- 为确保 SDK 在 RTC Engine 初始化阶段自动加载视频增强动态库，请勿手动删除该动态库。更多关于动态库的介绍详见[插件列表](/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size)。
:::

## 参数设置 [#参数设置]

### 美颜 [#美颜]

调用 `setBeautyEffectOptions`，并通过 `options` 参数调节各种美颜效果，详见 `setBeautyEffectOptions` 文档。

### 暗光增强 [#暗光增强]

调用 `setExtensionProperty`，并对参数进行如下设置：

- `provider_name` ：`agora_video_filters_clear_vision`

- `extension_name` ： `clear_vision`

- `key` ： `lowlight_enhance_option`

- `value` 参数中的 `enable`、`mode` 和 `level` 描述如下：

| 参数 | 描述 |
| --- | --- |
| [video-enhancement-markdown-0-1-0 details](#table-slot-video-enhancement-markdown-0-1-0) | [video-enhancement-markdown-0-1-1 details](#table-slot-video-enhancement-markdown-0-1-1) |
| [video-enhancement-markdown-0-2-0 details](#table-slot-video-enhancement-markdown-0-2-0) | [video-enhancement-markdown-0-2-1 details](#table-slot-video-enhancement-markdown-0-2-1) |
| [video-enhancement-markdown-0-3-0 details](#table-slot-video-enhancement-markdown-0-3-0) | [video-enhancement-markdown-0-3-1 details](#table-slot-video-enhancement-markdown-0-3-1) |

<a id="table-slot-video-enhancement-markdown-0-1-0"></a>

**video-enhancement-markdown-0-1-0 details**

`enable`
（开关）

<a id="table-slot-video-enhancement-markdown-0-1-1"></a>

**video-enhancement-markdown-0-1-1 details**

是否开启暗光增强：

- 0：（默认）关闭暗光增强。
- 1：开启暗光增强。

<a id="table-slot-video-enhancement-markdown-0-2-0"></a>

**video-enhancement-markdown-0-2-0 details**

`mode`
（模式）

<a id="table-slot-video-enhancement-markdown-0-2-1"></a>

**video-enhancement-markdown-0-2-1 details**

暗光增强模式：

- 0：（默认）自适应模式，可根据采集环境光照条件自动开启和关闭暗光增强功能。
- 1：手动模式。

<a id="table-slot-video-enhancement-markdown-0-3-0"></a>

**video-enhancement-markdown-0-3-0 details**

`level`
（等级）

<a id="table-slot-video-enhancement-markdown-0-3-1"></a>

**video-enhancement-markdown-0-3-1 details**

暗光增强等级：

- 0：（默认）画质优先，提高亮度的同时抑制画面噪声，但需要消耗更多 CPU 算力。
- 1：性能优先，可节省 CPU 算力、减少处理时间。

### 色彩增强 [#色彩增强]

调用 `setExtensionProperty`， 并对参数进行如下设置：

- `provider_name` ： `agora_video_filters_clear_vision`

- `extension_name` ： `clear_vision`

- `key` ： `color_enhance_option`

- `value` 参数中的 `enable`、`Strength` 和 `Skin Protection` 描述如下：

| 参数 | 描述 |
| --- | --- |
| [video-enhancement-markdown-1-1-0 details](#table-slot-video-enhancement-markdown-1-1-0) | [video-enhancement-markdown-1-1-1 details](#table-slot-video-enhancement-markdown-1-1-1) |
| [video-enhancement-markdown-1-2-0 details](#table-slot-video-enhancement-markdown-1-2-0) | [video-enhancement-markdown-1-2-1 details](#table-slot-video-enhancement-markdown-1-2-1) |
| [video-enhancement-markdown-1-3-0 details](#table-slot-video-enhancement-markdown-1-3-0) | [video-enhancement-markdown-1-3-1 details](#table-slot-video-enhancement-markdown-1-3-1) |

<a id="table-slot-video-enhancement-markdown-1-1-0"></a>

**video-enhancement-markdown-1-1-0 details**

`enable`
（开关）

<a id="table-slot-video-enhancement-markdown-1-1-1"></a>

**video-enhancement-markdown-1-1-1 details**

是否开启色彩增强：

- 0：（默认）关闭色彩增强。
- 1：开启色彩增强。

<a id="table-slot-video-enhancement-markdown-1-2-0"></a>

**video-enhancement-markdown-1-2-0 details**

`Strength`
（色彩增强强度）

<a id="table-slot-video-enhancement-markdown-1-2-1"></a>

**video-enhancement-markdown-1-2-1 details**

画面颜色饱和度的提升程度，取值范围为 [0.0,1.0]，默认值为 0.5。
 参数值越大，画面颜色饱和度越高。

<a id="table-slot-video-enhancement-markdown-1-3-0"></a>

**video-enhancement-markdown-1-3-0 details**

`Skin Protection`
（肤色保护强度）

<a id="table-slot-video-enhancement-markdown-1-3-1"></a>

**video-enhancement-markdown-1-3-1 details**

肤色被保护的强度，取值范围为 [0.0，1.0]，默认值为 1.0。
参数值越大、肤色受色彩增强的影响越小。

### 视频降噪 [#视频降噪]

调用 `setExtensionProperty`， 并对参数进行如下设置：

- `provider_name` ： `agora_video_filters_clear_vision`

- `extension_name` ： `clear_vision`

- `key` ： `video_denoiser_option`

- `value` 参数中的 `enable`、`mode` 和 `level` 描述如下：

 | 参数 | 描述 |
 | --- | --- |
 | [video-enhancement-markdown-2-1-0 details](#table-slot-video-enhancement-markdown-2-1-0) | [video-enhancement-markdown-2-1-1 details](#table-slot-video-enhancement-markdown-2-1-1) |
 | [video-enhancement-markdown-2-2-0 details](#table-slot-video-enhancement-markdown-2-2-0) | [video-enhancement-markdown-2-2-1 details](#table-slot-video-enhancement-markdown-2-2-1) |
 | [video-enhancement-markdown-2-3-0 details](#table-slot-video-enhancement-markdown-2-3-0) | [video-enhancement-markdown-2-3-1 details](#table-slot-video-enhancement-markdown-2-3-1) |

 <a id="table-slot-video-enhancement-markdown-2-1-0"></a>

 **video-enhancement-markdown-2-1-0 details**

 `enable`
 （开关）

 <a id="table-slot-video-enhancement-markdown-2-1-1"></a>

 **video-enhancement-markdown-2-1-1 details**

 是否开启视频降噪：

 - 0：（默认）关闭视频降噪。
 - 1：开启视频降噪。

 <a id="table-slot-video-enhancement-markdown-2-2-0"></a>

 **video-enhancement-markdown-2-2-0 details**

 `mode`
 （模式）

 <a id="table-slot-video-enhancement-markdown-2-2-1"></a>

 **video-enhancement-markdown-2-2-1 details**

 视频降噪模式：

 - 0：（默认）自适应模式，可根据采集环境光照条件自动开启和关闭视频降噪功能。
 - 1：手动模式。

 <a id="table-slot-video-enhancement-markdown-2-3-0"></a>

 **video-enhancement-markdown-2-3-0 details**

 `level`
 （等级）

 <a id="table-slot-video-enhancement-markdown-2-3-1"></a>

 **video-enhancement-markdown-2-3-1 details**

 视频降噪等级：

 - 0：（默认）时域降噪，降噪效果中等，抗拖影效果好，App 鲁棒性强，适用于大部分场景。
 - 1：快速降噪，降噪效果中等，适用于固定摄像头场景。
 - 2：在时域降噪的基础上增加了空域降噪，降噪效果强，提升画面纯净度，适用于高噪点场景。