Skip to main content

Virual Background API

Banuba provides the Virual Background API designed to help you integrate augmented reality background separation into your app. It aims to change your background to hide everything behind you.

Download example

tip

Read more about how to combine Virual Background API and effects.

tip

If you want to add background separation to an existing effect, see Face Beauty API.

The Virual Background API allows to change background with the following built-in features:

Background texture

Sets background behind the user to a texture.

  • Background.texture('image.png') - sets an image or a video file as a background texture. The file should be placed into the effect's folder.
  • Supported formats.
/* Feel free to add your custom code below */

Background.texture('image.png')

Preview

Drag

Background texture content mode

Scales the background content mode.

  • Background.contentMode(mode) - sets a content mode of background texture.
  • Available mods: scale_to_fill, fill, fit.
/* Feel free to add your custom code below */

Background.texture('image.png')
Background.contentMode('fit')
Drag

Background texture rotation

Rotates the background texture clockwise in degrees.

  • Background.rotation(angle) - sets background image rotation angle. Angle should be provided in degrees.
/* Feel free to add your custom code below */

Background.texture('image.png')
Background.rotation(90)

Preview

Drag

Background texture scale

Scales the background texture.

  • Background.scale(factor) - sets the scale factor of background texture.
/* Feel free to add your custom code below */

Background.texture('image.png')
Background.scale(2)

Preview

Drag

Background blur

Sets background blur radius.

  • Background.blur(radius) - set background blur radius in range from 0 to 1.
/* Feel free to add your custom code below */

Background.blur(0.6)

Preview

Drag

Background transparency

Sets background transparency value.

  • Background.transparency(value) - set background transparency value in range from 0 to 1. 0 - transparent background disabled , 1 - fully transparent background enabled
/* Feel free to add your custom code below */

Background.transparency(1)

Preview

Drag