URL Parameter: skipBrowserCheck

Using the Epic Context Aware Linking (CAL) integration, FDI records can be configured to send an additional parameter in their CAL links that will bypass VidyoPortal’s WebRTC browser check.

In most embedded browser use cases on Android and iOS, the browser’s User-Agent can be customized to the original application’s specifications. In these cases, the VidyoPortal may not recognize the browser as one that support WebRTC and thus not present the option to Join via Browser. When the skipBrowserCheck=1 parameter is present in the URL, the VidyoPortal and VidyoConnect for WebRTC application will bypass this check and always present the Join via Browser option.

Prerequisites

For the required component versions for this feature, see Epic CAL feature compatibility with Vidyo versions.

Using the parameter

The skipBrowserCheck URL parameter need to be placed outside the Epic CAL CRYPTSTRING as a part of the room link URL.

Parameter Value
skipBrowserCheck

0 — default, which displays the standard splash screen. Using 0 is equivalent to not specifying the parameter in the URL.

1 — bypasses the VidyoPortal check and always shows the Join via Browser option. This parameter is then automatically pass along to the VidyoConnect for WebRTC app.

Here is an example of a link in an FDI record that uses the jvw parameter:

https://epic.alpha.vidyo.com/join/?extDataType=1&extData=%CRYPTSTR%&skipBrowserCheck=1

Best practices

Here are a few best practices when using this feature:

  • If a room link with the skipBrowserCheck parameter is invoked on a browser that does not support WebRTC, the user will fail to join the conference. Vidyo makes a best effort to only show this option for browsers that are generally modern – but every possible combination cannot be tested.
  • Vidyo does not validate custom User-Agents for all possible embedded applications. This is up to the implementation team to validate in their user case.