Documentation sections
Virtual reality video scope of support
Radiant Media Player is committed to supporting the latest innovation in the online video world. We are pleased to announce support for virtual reality video through head-mounted display with Radiant Media Player 5.5.
Supported input format
Radiant Media Player supports playback for side by side videos, used in the context of a VR headset, through HLS, DASH & progressive download. This works for live or on-demand video content. Given the nature of side by side videos (which can easily scale up to 4K resolution) using an adaptive bitrate streaming like HLS or DASH technology is generally recommended. Example of VR-ready side-by-side video compatible with Radiant Media Player:
Supported environments
In order to provide side by side videos, used 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). As of version 5.5 we support the Oculus platform.
We support the Oculus browser, Samsung Internet VR and Firefox Reality.
Example of supported devices: Oculus Go, Oculus Quest & Samsung Gear VR
Supported features
Most player features generally available for Radiant Media Player are available for VR web browsers/platforms. Below is a non-exhaustive list of features you can expect to be available or not when using Radiant Media Player in a VR web browsers/platforms:
| Feature | Oculus platform |
|---|---|
| HLS | |
| AES HLS | |
| DASH | |
| Progressive download | |
| HTML5 video ads | |
| VOD & Live streaming | |
| DVR streaming | |
| Virtual reality module (1) | |
| Autoplay support (2) | |
| Audio-only | |
| Player API | |
| Widevine DRM | |
| ClearKey DRM | |
| Google Cast | |
| Offline playback |
(1) When Radiant Media Player is used in a supported platform/browser and the WebXR Device API is available within a context of a VR headset, a VR module will appear in the top-right corner of the player to allow for a fullscreen VR experience of the video content.
(2) Based on platform/browser capabilities only muted autoplay may be available.
Virtual reality 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.
videoVRFRameRate: Number
Sets the minimum FOV (Camera frustum vertical field of view) by focal length in respect to the current film gauge. Default: 24.
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/5.7.8/js/rmp-three-hlsjs.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>