# 如何使用视频增强插件? (/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) |
**video-enhancement-markdown-0-1-0 details**
`enable`
(开关)
**video-enhancement-markdown-0-1-1 details**
是否开启暗光增强:
- 0:(默认)关闭暗光增强。
- 1:开启暗光增强。
**video-enhancement-markdown-0-2-0 details**
`mode`
(模式)
**video-enhancement-markdown-0-2-1 details**
暗光增强模式:
- 0:(默认)自适应模式,可根据采集环境光照条件自动开启和关闭暗光增强功能。
- 1:手动模式。
**video-enhancement-markdown-0-3-0 details**
`level`
(等级)
**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) |
**video-enhancement-markdown-1-1-0 details**
`enable`
(开关)
**video-enhancement-markdown-1-1-1 details**
是否开启色彩增强:
- 0:(默认)关闭色彩增强。
- 1:开启色彩增强。
**video-enhancement-markdown-1-2-0 details**
`Strength`
(色彩增强强度)
**video-enhancement-markdown-1-2-1 details**
画面颜色饱和度的提升程度,取值范围为 [0.0,1.0],默认值为 0.5。
参数值越大,画面颜色饱和度越高。
**video-enhancement-markdown-1-3-0 details**
`Skin Protection`
(肤色保护强度)
**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) |
**video-enhancement-markdown-2-1-0 details**
`enable`
(开关)
**video-enhancement-markdown-2-1-1 details**
是否开启视频降噪:
- 0:(默认)关闭视频降噪。
- 1:开启视频降噪。
**video-enhancement-markdown-2-2-0 details**
`mode`
(模式)
**video-enhancement-markdown-2-2-1 details**
视频降噪模式:
- 0:(默认)自适应模式,可根据采集环境光照条件自动开启和关闭视频降噪功能。
- 1:手动模式。
**video-enhancement-markdown-2-3-0 details**
`level`
(等级)
**video-enhancement-markdown-2-3-1 details**
视频降噪等级:
- 0:(默认)时域降噪,降噪效果中等,抗拖影效果好,App 鲁棒性强,适用于大部分场景。
- 1:快速降噪,降噪效果中等,适用于固定摄像头场景。
- 2:在时域降噪的基础上增加了空域降噪,降噪效果强,提升画面纯净度,适用于高噪点场景。