io.agora.rtc2.video.VirtualBackgroundSource Class Reference

The custom background. More...

Public Member Functions
	VirtualBackgroundSource (int backgroundSourceType, int color, String source, int blurDegree)

Public Attributes
int	backgroundSourceType
int	color
String	source = null
int	blurDegree

Static Public Attributes
static final int	BACKGROUND_NONE = 0
static final int	BACKGROUND_COLOR = 1
static final int	BACKGROUND_IMG = 2
static final int	BACKGROUND_BLUR = 3
static final int	BACKGROUND_VIDEO = 4
static final int	BLUR_DEGREE_LOW = 1
static final int	BLUR_DEGREE_MEDIUM = 2
static final int	BLUR_DEGREE_HIGH = 3

Detailed Description

The custom background.

Member Data Documentation

BACKGROUND_NONE

final int io.agora.rtc2.video.VirtualBackgroundSource.BACKGROUND_NONE = 0

static

0: Enable segementation with the captured video frame without replacing the background.

BACKGROUND_COLOR

final int io.agora.rtc2.video.VirtualBackgroundSource.BACKGROUND_COLOR = 1

static

1: The background is a solid color(eg: Oxffffff).

BACKGROUND_IMG

final int io.agora.rtc2.video.VirtualBackgroundSource.BACKGROUND_IMG = 2

static

2: Image source in PNG or JPG format.

BACKGROUND_BLUR

final int io.agora.rtc2.video.VirtualBackgroundSource.BACKGROUND_BLUR = 3

static

3: Background blur. blur your background, not including your body.

BACKGROUND_VIDEO

final int io.agora.rtc2.video.VirtualBackgroundSource.BACKGROUND_VIDEO = 4

static

4: Video source in MP4, AVI, MKV, FLV format.

BLUR_DEGREE_LOW

final int io.agora.rtc2.video.VirtualBackgroundSource.BLUR_DEGREE_LOW = 1

static

blur degree low, have few blur effect

BLUR_DEGREE_MEDIUM

final int io.agora.rtc2.video.VirtualBackgroundSource.BLUR_DEGREE_MEDIUM = 2

static

blur degree medium, blur more than level 1

BLUR_DEGREE_HIGH

final int io.agora.rtc2.video.VirtualBackgroundSource.BLUR_DEGREE_HIGH = 3

static

blur degree high, blur default, hard to find background

backgroundSourceType

int io.agora.rtc2.video.VirtualBackgroundSource.backgroundSourceType

The custom background.

• BACKGROUND_NONE (0): Process the background as alpha data without replacement, only separating the portrait and the background. After setting this value, you can call startLocalVideoTranscoder to implement the picture-in-picture effect.
• BACKGROUND_COLOR (1): (Default) The background image is a solid color.
• BACKGROUND_IMG (2): The background image is a file in PNG or JPG format.
• BACKGROUND_BLUR (3): The background is a blurred version of the original background.
• BACKGROUND_VIDEO (4): The background is a local video in MP4, AVI, MKV, FLV, or other supported formats.

color

int io.agora.rtc2.video.VirtualBackgroundSource.color

The type of the custom background image. The color of the custom background image. The format is a hexadecimal integer defined by RGB, without the # sign, such as 0xFFB6C1 for light pink. The default value is 0xFFFFFF, which signifies white. The value range is [0x000000, 0xffffff]. If the value is invalid, the SDK replaces the original background image with a white background image.

Note

This parameter is only applicable to custom backgrounds of the following types:

• BACKGROUND_COLOR: The background image is a solid-colored image of the color passed in by the parameter.
• BACKGROUND_IMG: If the image in source has a transparent background, the transparent background will be filled with the color passed in by the parameter.

source

String io.agora.rtc2.video.VirtualBackgroundSource.source = null

The local absolute path of the custom background image. Supports PNG, JPG, MP4, AVI, MKV, and FLV formats. If the path is invalid, the SDK will use either the original background image or the solid color image specified by color.

Note

This parameter takes effect only when the type of the custom background image is BACKGROUND_IMG or BACKGROUND_VIDEO.

blurDegree

int io.agora.rtc2.video.VirtualBackgroundSource.blurDegree

The degree of blurring applied to the custom background image.

• BLUR_DEGREE_LOW (1): The degree of blurring applied to the custom background image is low. The user can almost see the background clearly.
• BLUR_DEGREE_MEDIUM (2): The degree of blurring applied to the custom background image is medium. It is difficult for the user to recognize details in the background.
• BLUR_DEGREE_HIGH (3): The degree of blurring applied to the custom background image is high. The user can barely see any distinguishing features in the background.

  Note

  This parameter takes effect only when the type of the custom background image is BACKGROUND_BLUR.