enableVirtualBackground abstract method

Future<int> enableVirtualBackground(
  1. bool enabled,
  2. NERtcVirtualBackgroundSource? backgroundSource
)

开启/关闭虚拟背景。 启用虚拟背景功能后,您可以使用自定义背景图片替换本地用户的原始背景图片。 替换后,频道内所有用户都可以看到自定义背景图片。

说明

  • 建议您在满足以下条件的场景中使用该功能:
    • 采用高清摄像设备,环境光线均匀。
    • 捕获的视频图像整洁,用户肖像半长且基本无遮挡,并且背景是与用户衣服颜色不同的单一颜色。
  • 虚拟背景功能不支持在 Texture 格式的视频或通过 Push 方法从自定义视频源获取的视频中设置虚拟背景。
  • 若您设置背景图片为自定义本地图片,SDK 会在保证背景图片内容不变形的前提下,对图片进行一定程度上的缩放和裁剪,以适配视频采集分辨率。

参数说明

enabled 设置是否开启虚拟背景。

backgroundSource 自定义背景图片。详细信息请参考NERtcVirtualBackgroundSource

相关回调

您可以通过 NERtcChannelEventCallback.onVirtualBackgroundSourceEnabled 回调查看虚拟背景是否开启成功或出错原因。

Implementation

Future<int> enableVirtualBackground(
    bool enabled, NERtcVirtualBackgroundSource? backgroundSource);