Radiant Media Player

Progressive download documentation



Documentation sections


Supported formats & features for progressive download

Radiant Media Player supports progressive download in MP4 (H.264/AAC or H.265/AAC) & WebM formats (VP8/VP9 video with Vorbis/Opus audio) to HTML5 video and M4A (AAC), MP3 or OGG (Vorbis/Opus) formats to HTML5 audio. For audio-only streaming please refer to our audio-only documentation page.

Whenever possible we recommend using an adaptive streaming technology (HLS or DASH) over progressive download as an adaptive streaming technology will provide more playback options, save bandwidth and offer an overall better viewing experience for your audience. That being said progressive download remains a widely used method of delivering media content to web environments so Radiant Media Player fully support this method of delivery.

When using progressive download the fetching of media content is completely left to the browser. Progressive download is only available for on-demand media content delivery. In order to maximise compatibility across devices it is recommended to provide an MP4 and a WebM rendition for your media to the player.

Generally available features like video ads, JavaScript API or playback rate changes are also supported with progressive download to Radiant Media Player. When multiple MP4/WebM files are provided to the player it will display a manual bitrate selection menu. There will be no automatic adaptation logic between those files with progressive download - it is up to the viewer to opt for a specific bitrate.


Supported environments

See our compatibility table for a list of environments where progressive download is supported with Radiant Media Player.


Player code example

In this example we use a combination of MP4/WebM for on-demand video:

<!-- Include Radiant Media Player JavaScript file in your <body> or <head> -->
<script src="https://cdn.radiantmediatechs.com/rmp/5.0.3/js/rmp.min.js"></script>
<!-- Player container element -->
<div id="rmpPlayer"></div>
<!-- Set up player configuration options -->
<script>
// Here we pass our MP4 streaming sources - we can pass different renditions at various quality
// We may also provide WebM sources as a fallback for devices where H264/AAC in MP4 is not supported
var src = {
  mp4: [
    'https://your-mp4-sd-url.mp4',
    'https://your-mp4-hd-url.mp4',
    'https://your-mp4-full-hd-url.mp4'
  ],
  webm: [
    'https://your-webm-sd-url.webm',
    'https://your-webm-hd-url.webm',
    'https://your-webm-full-hd-url.webm'
  ]
};
var settings = {
  licenseKey: 'your-license-key',
  src: src,
  width: 640,
  height: 360,
  poster: 'https://your-poster-url.jpg'
};
var elementID = 'rmpPlayer';
var rmp = new RadiantMP(elementID);
rmp.init(settings);
</script>

Progressive download player settings

initialBitrate: Number

This setting tells the player which MP4/WebM bitrate to select when player loads. It represents the index from the related src.mp4 or src.webm array. Default: 0 (which is the first item from the src.mp4 or src.webm array).

webmFirst: Boolean

This setting tells the player to use WebM progressive download as a first choice over MP4 progressive download (by default the player will opt for MP4 progressive download first) when both are available and valid playback options. Default: false.

webmCodecs: Object

For WebM progressive download we can specify which type of audio/video codecs to test against within the browser. Valid video codecs are 'vp8', 'vp9' or VP9 with custom profile (example: 'vp09.00.10.08'). Valid audio codecs values are 'vorbis' and 'opus'. Adjust this setting based on the encoding of your WebM content. Default is:

webmCodecs: {
  video: 'vp8',
  audio: 'vorbis'
}

HEVC support

As of June 2017 only Desktop MS Edge on Windows 10 with proper hardware configuration supports MP4 with HEVC video & HE-AAC audio. Other devices/browsers may start supporting HEVC at a later stage. In the meantime you should want to use MP4 with both HEVC/AAC and AVC/AAC and let the player decices what to do. This is made possible with the mp4Hevc property of the above src object. Example:

var src = {
  mp4Hevc: [
    'https://your-mp4-hevc-url.mp4'
  ],
  mp4: [ 
    'https://your-mp4-avc-url.mp4'
  ]
};
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License.