# 虚拟背景 (/zh-CN/api-reference/rtc/harmonyos/video/video-prenpro/virtualbackground) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## enableVirtualBackground [#enablevirtualbackground] 开启虚拟背景并指定媒体源,或关闭虚拟背景。 ```ts public abstract enableVirtualBackground(enabled:boolean,backgroundSource:VirtualBackgroundSource,segproperty:SegmentationProperty,sourceType?:Constants.MediaSourceType):number; ``` ### 详情 [#详情] 虚拟背景功能支持将本地用户原来的背景替换为静态图片、动态视频、将背景虚化,或者将人像与背景分割以实现人像画中画。成功开启虚拟背景功能后,频道内所有用户都能看到自定义的背景。 请在 [enableVideo](/zh-CN/api-reference/rtc/harmonyos/video/video-basic#api_irtcengine_enablevideo) 或 [startPreview](/zh-CN/api-reference/rtc/harmonyos/video/video-basic#api_irtcengine_startpreview2) 之后调用该方法。 :::caution 注意: - 该功能对设备性能要求较高,调用该方法时 SDK 会自动对当前设备能力进行检查。建议你在搭载如下芯片的设备上使用: - 建议你在满足如下条件的场景中使用该功能: - 使用高清摄像设备、摄像环境光照均匀。 - 摄像画面中,物件较少,用户的人像为半身人像且基本无遮挡,背景色较单一且与用户着装颜色不同。 - 该方法依赖于虚拟背景动态库 `libagora_segmentation_extension.so`,如果删除该动态库会导致无法正常开启该功能。 ::: ### 参数 [#参数] 是否开启虚拟背景: - `true`: 开启虚拟背景。 - `false`: 关闭虚拟背景。 自定义的背景。详见 [VirtualBackgroundSource](/zh-CN/api-reference/rtc/harmonyos/class-virtualbackgroundsource)。为将自定义背景图的分辨率与 SDK 的视频采集分辨率适配,SDK 会在保证自定义背景图不变形的前提下,对自定义背景图进行缩放和裁剪。 背景图像的处理属性。详见 [SegmentationProperty](/zh-CN/api-reference/rtc/harmonyos/class-segmentationproperty)。 应用效果的媒体源。详见 [MediaSourceType](/zh-CN/api-reference/rtc/harmonyos/enum-mediasourcetype)。 ### 返回值 [#返回值] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -4:设备能力不满足虚拟背景的使用要求,建议更换性能更高的设备。 ### 所属接口类 [#所属接口类] - [RtcEngine](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_irtcengine)