of 3

Documentation

Unblu 7 (latest)

This article provides information on how to set up Unblu to use LiveKit to establish audio and video calls.

How LiveKit works in general is outlined in the LiveKit documentation.

This is a preview feature. It may be subject to change or removal with no further notice.

To enable preview features, set com.unblu.platform.enablePreview to true.

For more information on preview features, refer to the Unblu release policy

Deployment options

Unblu Cloud and LiveKit

If you are using Unblu Cloud, LiveKit is provided as a service out of the box and you don’t have to configure anything.

Unblu on-premises and LiveKit in the Unblu Cloud

If you have an Unblu on-premises installation, you can still use LiveKit as an Unblu Cloud service. In this case, you must configure Unblu to use LiveKit as explained below, but Unblu provides you with the server, API keys, and secrets required for LiveKit.

Unblu on-premises and LiveKit

If you choose to run LiveKit on-premises, you have to set up and deploy your own LiveKit server. For more information on how to do so, refer to the LiveKit documentation.

LiveKit offers several deployment models, such as to a single VM (not scalable, and limited to up to 3000 call participants), or to a scalable Kubernetes cluster.

Configuring Unblu to use LiveKit

Once you’ve set up your LiveKit server, configure Unblu to use it. Set the following configuration properties at the ACCOUNT level:

Video chat limitations

  • If a visitor navigates to a new page inside the Unblu-instrumented web page, the video connection is disrupted while the page loads and automatically re-establishes a connection as soon as possible. To work around this, visitors can use the pop-out feature.

  • The video chat can only be displayed in one browser window or tab. If the visitor has several tabs or windows open and they belong to the same Unblu conversation, the video chat stays in one window. If the user wants to transfer the video chat to a different window, they can do so in the chat user interface.

  • Currently, Unblu only supports up to six concurrent video chat participants.

  • Snapshots aren’t supported.

  • Audio level indicators aren’t supported. A workaround is in place to indicate if a participant is speaking.

  • Video background blur isn’t available for implementations based on LiveKit at this time.

See also