Radiant Media Player

Progressive download documentation



Supported formats & features for progressive download

Radiant Media Player supports progressive download in MP4 (H.264/AAC) & WebM formats (VP8/VP9 video with Vorbis/Opus audio) to HTML5 video and M4A (AAC) & MP3 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/4.4.19/js/rmp.min.js" 
  integrity="sha384-MHxuw6s8n+Uh8xT1LYC0zcidvLkX9DN0otZPYoamhjIU8svCQARWXpRYEXV6o6LI"
  crossorigin="anonymous"></script>
<!-- Set up your wrapper div with its unique id -->
<div id="rmpPlayer"></div>
<!-- Set up player configuration options -->
<script>
var bitrates = {
  mp4: [
    'https://www.rmp-streaming.com/media/bbb-360p.mp4',
    'https://www.rmp-streaming.com/media/bbb-576p.mp4',
    'https://www.rmp-streaming.com/media/bbb-720p.mp4'
  ],
  webm: [
    'https://www.rmp-streaming.com/media/bbb-360p.webm',
    'https://www.rmp-streaming.com/media/bbb-576p.webm',
    'https://www.rmp-streaming.com/media/bbb-720p.webm'
  ]
};
var settings = {
  licenseKey: 'your-license-key',
  bitrates: bitrates,  
  delayToFade: 3000,
  width: 640,
  height: 360,
  poster: 'https://www.radiantmediaplayer.com/images/poster-rmp-showcase.jpg'
};
// Reference to the wrapper div (unique id)
var elementID = 'rmpPlayer';
// Create an object based on RadiantMP constructor
var rmp = new RadiantMP(elementID);
// Initialization ... test your page and done!
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 bitrates.mp4 or bitrates.webm array. Default: 0 (which is the first item from the bitrates.mp4 or bitrates.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' and 'vp9'. Valid audio codecs 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 bitrates object. Example:

var bitrates = {
  mp4Hevc: [
    'https://www.rmp-streaming.com/media/ed-hevc-360p-2m.mp4'
  ],
  mp4: [ 
    'https://www.rmp-streaming.com/media/ed-360p.mp4'
  ]
};
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License.