# VirtualBackgroundSource (/zh-CN/api-reference/rtc/unreal-cpp/class-virtualbackgroundsource)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
```cpp
struct VirtualBackgroundSource {
enum BACKGROUND_SOURCE_TYPE {
BACKGROUND_NONE = 0,
BACKGROUND_COLOR = 1,
BACKGROUND_IMG = 2,
BACKGROUND_BLUR = 3,
BACKGROUND_VIDEO = 4,
};
enum BACKGROUND_BLUR_DEGREE {
BLUR_DEGREE_LOW = 1,
BLUR_DEGREE_MEDIUM = 2,
BLUR_DEGREE_HIGH = 3,
};
BACKGROUND_SOURCE_TYPE background_source_type;
unsigned int color;
const char* source;
BACKGROUND_BLUR_DEGREE blur_degree;
VirtualBackgroundSource() : background_source_type(BACKGROUND_COLOR), color(0xffffff), source(NULL), blur_degree(BLUR_DEGREE_HIGH) {}
};
```
## 属性 [#属性]
自定义的背景。详见 [BACKGROUND_SOURCE_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-backgroundsourcetype)。
自定义的背景图颜色。格式为 RGB 定义下的十六进制整数,不带 # 号,如 0xFFB6C1 表示浅粉色。 默认值为 0xFFFFFF,表示白色。 取值范围为 [0x000000,0xffffff]。如果取值非法,SDK 会用白色背景图替换原背景图。
:::caution
注意: 该参数仅在自定义背景为以下类型时生效,具体效果如下:
- BACKGROUND_COLOR:背景图为该参数传入颜色的纯色图片。
- BACKGROUND_IMG:如果 source 中的图片使用了透明背景,则会使用该参数传入的颜色填充透明背景。
:::
自定义背景的本地绝对路径。支持 PNG、JPG、MP4、 AVI、 MKV 和 FLV 格式。如果路径无效,SDK 会使用原背景图或 color 指定的纯色背景。
:::caution
注意: 该参数仅在自定义背景图类型为 BACKGROUND_IMG 或 BACKGROUND_VIDEO 时生效。
:::
自定义背景图的模糊程度。详见 [BACKGROUND_BLUR_DEGREE](/zh-CN/api-reference/rtc/unreal-cpp/enum-backgroundblurdegree)。
:::caution
注意: 该参数仅在自定义背景图类型为 BACKGROUND_BLUR 时生效。
:::