文档中心
全部产品
Console Agora.io 社区 提交工单

如何使用视频增强插件?

分类: 集成类    平台: Android / iOS / macOS / Windows   最后更新时间: 2022/06/01 18:40:20

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

功能介绍

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

  • 美颜

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

  • 暗光增强

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

  • 色彩增强

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

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

  • 视频降噪

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

  • 视频增强对设备性能有影响,请根据实际场景需求和用户设备性能适度使用视频增强。

  • 如需开启视频增强功能,你需要在调用 API 前集成视频增强动态库,详见插件列表

参数设置

美颜

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

暗光增强

调用 setExtensionProperty,并对参数进行如下设置:

  • provider_nameagora

  • extension_namebeauty

  • keylowlight_enhance_option

  • value 参数中的 enablemodelevel 描述如下:

参数 描述
enable
(开关)
是否开启暗光增强:
  • 0:(默认)关闭暗光增强。
  • 1:开启暗光增强。
mode
(模式)
暗光增强模式:
  • 0:(默认)自适应模式,可根据采集环境光照条件自动开启和关闭暗光增强功能。
  • 1:手动模式。
level
(等级)
暗光增强等级:
  • 0:(默认)画质优先,提高亮度的同时抑制画面噪声,但需要消耗更多 CPU 算力。
  • 1:性能优先,可节省 CPU 算力、减少处理时间。

色彩增强

调用 setExtensionProperty, 并对参数进行如下设置:

  • provider_nameagora

  • extension_namebeauty

  • keycolor_enhance_option

  • value 参数中的 enableStrengthSkin Protection 描述如下:

    参数 描述
    enable
    (开关)
    是否开启色彩增强:
    • 0:(默认)关闭色彩增强。
    • 1:开启色彩增强。
    Strength
    (色彩增强强度)
    画面颜色饱和度的提升程度,取值范围为 [0.0,1.0],默认值为 0.5。
    参数值越大,画面颜色饱和度越高。
    Skin Protection
    (肤色保护强度)
    肤色被保护的强度,取值范围为 [0.0,1.0],默认值为 1.0。
    参数值越大、肤色受色彩增强的影响越小。

视频降噪

调用 setExtensionProperty, 并对参数进行如下设置:

  • provider_nameagora

  • extension_namebeauty

  • keyvideo_denoiser_option

  • value 参数中的 enablemodelevel 描述如下:

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