通知
本站点除 Legacy 产品与方案外，已迁移至 声网新文档中心 ，当前页面不再维护
文档中心
全部产品
Console 官网 社区 技术支持
简体中文
search-icon

如何使用视频增强插件？

分类: 集成类    平台: Android / iOS / macOS / Windows   最后更新时间: 2023/02/05 20:32:44

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

功能介绍

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

  • 美颜

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

  • 暗光增强

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

  • 色彩增强

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

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

  • 视频降噪

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

- 视频增强对设备性能有影响，请根据实际场景需求和用户设备性能适度使用视频增强。 - 为确保 SDK 在 RTC Engine 初始化阶段自动加载视频增强动态库，请勿手动删除该动态库。更多关于动态库的介绍详见[插件列表](./faq/reduce_app_size_ng)。

参数设置

美颜

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

暗光增强

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

  • provider_name ：agora_video_filters_clear_vision

  • extension_name ： clear_vision

  • key ： lowlight_enhance_option

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

参数 描述
enable
（开关）		 是否开启暗光增强：
  • 0：（默认）关闭暗光增强。
  • 1：开启暗光增强。
mode
（模式）		 暗光增强模式：
  • 0：（默认）自适应模式，可根据采集环境光照条件自动开启和关闭暗光增强功能。
  • 1：手动模式。
level
（等级）		 暗光增强等级：
  • 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 描述如下：

参数 描述
enable
（开关）		 是否开启色彩增强：
  • 0：（默认）关闭色彩增强。
  • 1：开启色彩增强。
Strength
（色彩增强强度）		 画面颜色饱和度的提升程度，取值范围为 [0.0,1.0]，默认值为 0.5。
参数值越大，画面颜色饱和度越高。
Skin Protection
（肤色保护强度）		 肤色被保护的强度，取值范围为 [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 描述如下：

    参数 描述
    enable
    （开关）    		 是否开启视频降噪：
    • 0：（默认）关闭视频降噪。
    • 1：开启视频降噪。
    mode
    （模式）    		 视频降噪模式：
    • 0：（默认）自适应模式，可根据采集环境光照条件自动开启和关闭视频降噪功能。
    • 1：手动模式。
    level
    （等级）    		 视频降噪等级：
    • 0：（默认）时域降噪，降噪效果中等，抗拖影效果好，app 鲁棒性强，适用于大部分场景。
    • 1：快速降噪，降噪效果中等，适用于固定摄像头场景。
    • 2：在时域降噪的基础上增加了空域降噪，降噪效果强，提升画面纯净度，适用于高噪点场景。