Documentation

Radiant Media Player

Virtual reality video documentation

Virtual reality video scope of support

Radiant Media Player is committed to supporting the latest innovation in the online video world. As part of this commitment we support VR video, viewable through a head-mounted display through a web browser on most popular Virtual reality platforms.

Supported input format

Radiant Media Player supports playback for VR 180 video (also known as 180 3D video or side by side videos) viewed in a VR headset, through HLS & DASH. VR 180 is a video file containing 2 channels of video for the left and right eye, but for only the front facing 180 degree field of view. A more detailed explanation about VR and 360 video formats can be found here.

This works for live or on-demand video content. Example of VR-ready side-by-side video compatible with Radiant Media Player:

VR-ready side-by-side video image example

Supported environments

In order to provide support for VR 180 video, viewed in the context of a VR headset, Radiant Media Player makes use of the WebXR Device API. We use three.js as VR framework (this framework is publicly available under MIT license).

We support:

Supported features

Most player features generally available for Radiant Media Player are available for VR video. Below is a non-exhaustive list of features you can expect to be available when using Radiant Media Player in Web VR environment:

Oculus platform Oculus platform Microsoft mixed reality platform Google Cardboard platform
Features Oculus browser Firefox reality MS Edge 79+ Chrome 79+ for Android 5+
VR module for immersive-vr playback
HLS (HLS-TS & CMAF/fmp4 HLS)
DASH
HEVC
VP9
HTML5 video ads (1)
VOD, Live and DVR streaming
Multi-languages audio and captions
Autoplay with sound (2) (3)
Widevine DRM
PlayReady DRM

(1) Video ads will only be visible when the player is viewed inline. When the player has entered VR mode (immersive-vr), video ads will automatically be discarded.

(2) Autoplay, even muted, is not available on Firefox reality

(3) Muted autoplay is the only autoplay mode available

Virtual reality module

When Radiant Media Player is used in a supported environment and the WebXR Device API is available, a VR module will appear in the top-right corner of the player (VR glasses icon). When clicked this module will cause the player to enter immersive-vr mode.

HTTPS requirement

Using or testing Radiant Media Player VR feature requires you to use a full HTTPS environment (both streaming URLs and the site itself must be HTTPS). Failure to comply with this requirement could cause the player to not display the VR module or to fail at displaying VR-180 content.

Player settings

videoVR: Boolean

When set to true this setting will cause the player to enter VR rendering mode (where supported). Default: false.

videoVRFocalLength: Number

Sets the initial FOV (Camera frustum vertical field of view) by focal length in respect to the current film gauge. Default: 75.

Player code example - see this example here

The above player example has the following setup code:

<!-- Include Radiant Media Player - here we use the optimised build for hls.js and VR video -->
<script src="https://cdn.radiantmediatechs.com/rmp/6.2.3/js/rmp-three-hlsjs-xr.min.js"></script>
<div id="rmpPlayer"></div>
<script>
var src = {
  hls: 'https://your-vr-hls-url.m3u8'
};
var settings = {
  licenseKey: 'your-license-key',
  src: src,
  width: 640,
  height: 360,
  videoVR: true,
  contentMetadata: {
    poster: [
      'https://your-poster-url.jpg'
    ]
  }
};
var elementID = 'rmpPlayer';
var rmp = new RadiantMP(elementID);
rmp.init(settings);
</script>
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License.

©2015-2021 Radiant Media Player. All rights reserved.