of 3

Documentation

Unblu 7 (latest)

Unblu allows video and voice communication during sessions using webRTC-based video provider Vonage Video API (formerly Tokbox).

Requirements

Please refer to the articles Network requirements to run video and Video requirements for information on the technical requirements to conduct video calls.

Video & voice configuration

To enable video and voice calls on the Unblu server, you must first retrieve a video API key and secret from the Unblu delivery center and add them to your account configuration. You should have the video API key and secret before performing the following steps.

video configuration
  1. In the Account Configuration interface, go to Settings…​ Settings then, in the Filter field enter the word 'video'. A single item, Enable video chat displays. (You must select this to enable video but here we want first to apply the API key and secret before enabling video.)

  2. Select the Advanced button (further options drop-down) then select the Show Internal check box. Now all available items display.

  3. Paste the API key into the apiKey field and paste the secret into the apiSecret field then select the Save button. The product is now enabled for video. (Although some further configuration is required to apply options from the table below.)

  4. Select other options as required. Review the section Conversation call configuration of the configuration properties reference for an overview of the available options.

Additional configuration steps in on-premises installations

If you are using video chat with an on-premises installation of Unblu, you need to make sure that the Unblu server is able to connect to https://api.opentok.com. If it must use a forward proxy to reach the site, please configure the proxy in your configuration.properties file:

Technical label Description

com.unblu.chat.videochat.proxyUrl

Definition of the proxy type (only HTTP supported at the moment), username, password, proxy hostname and proxy port in the format http://[<username>:<password>@]<host>:<port>. Omit [<username>:<password>@] if your proxy does not require authentication. + Example: com.unblu.chat.videochat.proxyUrl=http://proxyUsername:[email protected]:80

com.unblu.chat.videochat.proxyAuthScheme

The authentication schema to use. Supported values are BASIC, DIGEST, NTLM, KERBEROS and SPNEGO + Example: com.unblu.chat.videochat.proxyAuthScheme=BASIC

Routing client internet traffic

If you are concerned about transmitting data that could be used to determine your clients' location, you can use an IP proxy to mediate between the Vonage servers and the video call client applications. To do so, provide the address of the proxy to be used by client applications in the configuration property com.unblu.chat.videochat.clientProxyUrl.

The IP proxy will be used for all traffic other than media streams (that is, the actual video call). This includes calls to the Vonage Video API, Websocket connections, and log traffic. You must therefore ensure that the proxy you specify is capable of handling calls of these kinds. It must also be capable of handling CORS HTTP headers.

Using custom TURN servers

Like video & voice calls, Unblu’s universal co-browsing and/or document co-browsing features require a TURN server. You may therefore want to use the same TURN servers for all of these features. To do so, set the configuration property com.unblu.chat.videochat.customTurnEnabled to true. That way, Unblu will establish video & voice calls using the TURN server or servers specified in the configuration property com.unblu.webrtc.iceServers. Additionally, set the configuration property com.unblu.chat.videochat.sessionType to RELAYED.

Video & voice communication in action

To test your video chat setup, you need to create a video chat session. Have a look in the video chat section of the user guide in order to see how that works.

Video chat limitations

  • If the visitor navigates to a new page inside the Unblu instrumented web page the video connection will be disrupted during the page load and will automatically re-establish a connection as soon as possible. To overcome this problem the visitor can use the Pop out Feature.

  • The video chat can only be displayed in one window / tab. If the visitor has several tabs / windows open that belong to the same Unblu Conversation, the video chat will stay in one window. If the user wants to transfer the video chat to a different window, they can do this in the chat user interface.

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