# FVirtualBackgroundSource (/zh-CN/api-reference/rtc/unreal-blueprint/class-virtualbackgroundsource)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
```cpp
USTRUCT(BlueprintType)
struct FVirtualBackgroundSource
{
GENERATED_BODY()
public:
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VirtualBackgroundSource")
EBACKGROUND_SOURCE_TYPE background_source_type = EBACKGROUND_SOURCE_TYPE::BACKGROUND_COLOR;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VirtualBackgroundSource")
int64 color = 0xffffff;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VirtualBackgroundSource")
FString source = "";
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|VirtualBackgroundSource")
EBACKGROUND_BLUR_DEGREE blur_degree = EBACKGROUND_BLUR_DEGREE::BLUR_DEGREE_HIGH;
FVirtualBackgroundSource(){}
FVirtualBackgroundSource(const agora::rtc::VirtualBackgroundSource & AgoraData){
background_source_type = static_cast(AgoraData.background_source_type);
color = AgoraData.color;
source = AgoraData.source;
blur_degree = static_cast(AgoraData.blur_degree);
}
agora::rtc::VirtualBackgroundSource CreateAgoraData() const {
agora::rtc::VirtualBackgroundSource AgoraData;
AgoraData.background_source_type = static_cast(background_source_type);
AgoraData.color = color;
SET_UABT_FSTRING_TO_CONST_CHAR___MEMALLOC(AgoraData.source, this->source)
AgoraData.blur_degree = static_cast(blur_degree);
return AgoraData;
}
void FreeAgoraData(agora::rtc::VirtualBackgroundSource& AgoraData) const {
SET_UABT_FSTRING_TO_CONST_CHAR___MEMFREE(AgoraData.source)
}
};
```
## 属性 [#属性]
自定义的背景。详见 [EBACKGROUND_SOURCE_TYPE](/zh-CN/api-reference/rtc/unreal-blueprint/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 时生效。
:::
自定义背景图的模糊程度。详见 [EBACKGROUND_BLUR_DEGREE](/zh-CN/api-reference/rtc/unreal-blueprint/enum-backgroundblurdegree)。
:::caution
注意: 该参数仅在自定义背景图类型为 BACKGROUND_BLUR 时生效。
:::