Radiant Media Player


Documentation sections

Autoplay scope of support in Radiant Media Player

TL;DR with the release of desktop Chrome 66 and Safari 11 autoplay with sound is becoming widely unavailable or restricted in the web industry. If you plan on using autoplay, we recommend using a unified muted autoplay approach which works well on mobile and desktop. Muted autoplay in Radiant Media Player can be achieved by using autoplay and muted settings set to true.

Autoplay (or autostart) allows media content or pre-roll advertisement to start without the need for a user interaction - most of the time autoplay happens when page loads.

Radiant Media Player provides support for autoplay of media content or pre-roll advertisement with live, DVR & on-demand streaming. Autoplay works with all supported streaming protocols (HLS, DASH or progressive download). Autoplay of outstream video ads is also supported. On modern mobile devices autoplay with audio is not available but muted autoplay can be used.

Years of autoplay with sound misusage in the industry have caused viewers to grow weary of autoplaying video with sound. Major actors in the industry have picked up on this trend and new autoplay policies are being rolled out into major browsers and devices. Those new policies tend to limit autoplay capabilities while pointing at muted autoplay as being the new standard for autoplaying video content, be it for mobile or desktop devices. With Radiant Media Player muted autoplay can be achieved by setting autoplay and muted player settings to true. Autoplay with audio remains available in some desktop browsers but it is likely to be increasingly blocked in the short-to-mid term future. You can check our compatibility table for more information on the subject.

Radiant Media Player is equipped with various detection and fallback mechanisms to insure your content remains watch-able whether you are using autoplay or not. When autoplay is requested but blocked by the browser (or another interfering mechanism), the player will gracefully provide a play icon to start content. We regularly test our player against Chrome 66+, Firefox (w/ media.autoplay.enabled set to false) and macOS Safari 11+ autoplay interference engines.

The below player settings can help fine tuning your autoplay set up.

An example of implementation with video ads can be found here.

Note about un-muting: these new policies in Chrome 66+ (and Safari 11+) also affect un-muting of video content or video ads. Specifically a mouseenter or mouseover event is not enough anymore to un-mute content if the user has not interacted with document prior to un-muting (this would cause the player to pause and throw a warning in the browser console). A full click or touchend event is now required.

Player code example

<!-- Include Radiant Media Player JavaScript file in your <body> or <head> -->
<script src="https://cdn.radiantmediatechs.com/rmp/4.10.1/js/rmp.min.js" 
<!-- Set up our container div with its unique id -->
<div id="rmpPlayer"></div>
// First we specify our streaming URL
var bitrates = {
  hls: 'https://www.rmp-streaming.com/media/hls/test-vectors/bbb-abr/playlist.m3u8'
// Then we set our player settings
var settings = {
  licenseKey: 'your-license-key',
  bitrates: bitrates,
  width: 640,
  height: 360,
  // Since Chrome 66+ and Safari 11+ autoplay with sound is blocked by default on page load
  // We thus recommend using a unified muted autoplay approach that works well on both desktop and mobile
  muted: true,
  autoplay: true,
  // To enable autoplay of video ads just add ad-related settings
  // ads: true,
  // adTagUrl: 'https://www.radiantmediaplayer.com/vast/tags/inline-linear.xml',
  poster: 'https://www.radiantmediaplayer.com/images/poster-rmp-demo.jpg'
var elementID = 'rmpPlayer';
var rmp = new RadiantMP(elementID);

Muted autoplay support in mobile browsers

With the release of iOS 10 and Chrome 53 on Android muted autoplay of HTML5 video has been introduced on mobile devices. Previously it was not possible to autoplay video content on iOS & Android browsers even muted. Radiant Media Player has supported muted autoplay for content since the release of iOS 10 and Chrome 53 for Android browsers. With the release of Google IMA SDK 3.164.0 we have also added muted autoplay support for video ads (version 4.0.19) on mobile devices. Muted autoplay of video ads is also possible with our VAST parser rmp-vast. Autoplay with sound (e.g. not muted) is still not possible on iOS or Android browsers as of July 2017 and we do not expect this to change in the near future.

Our testing shows that muted autoplay of preroll video ads or video content works well in latest Safari & Chrome for iOS 10+ and latest Chrome & Firefox for Android 4.4+. Browsers like Samsung Internet do not seem to currently provide support for muted autoplay and as such those browsers are unlikely to support this feature.

Mobile/browser modes that could prevent autoplay

Low power mode on iOS 11+

According to our testing when an iOS 11+ device is in low power mode autoplay even muted is forbidden by the OS. This does not apply to iOS 10 and below. Radiant Media Player will properly handle autoplay requests when low power mode is engaged in iOS 11+ by providing a play button to initiate playback (a user interaction will be needed in such case as autoplay would have failed).

Data saver mode on Chrome before version 66 for Android

When data saver mode is enabled on Chrome before version 66 for Android autoplay even muted is forbidden by the OS. Note that this only applies to non-https web pages so on an https site (which should be the norm by now) autoplay won't be affected by data saver mode (meaning that muted autoplay will work as usual).

Autoplay-related player settings

autoplay: Boolean

Command the player to autoplay content when init method is called. This works for media content and video ads. On modern mobile devices muted autoplay is supported for media content and video ads. Default: false.

mutedAutoplayOnMobile: Boolean

In latest mobile browsers muted autoplay of content/pre-roll ad is supported. When both autoplay and mutedAutoplayOnMobile are set to true the player will use muted autoplay on mobile browsers. Setting mutedAutoplayOnMobile to false while autoplay is set to true will cause the player to only autoplay on desktop browsers. Default: true.

mutedAutoplayOnMacosSafari11Plus: Boolean

With the release of macOS Safari 11 Apple started blocking autoplay of media content with audio by default. It is still possible to use, to some extend, muted autoplay (assuming a user has not set "Never Auto-Play" in her/his Safari preference). When autoplay is set to true and mutedAutoplayOnMacosSafari11Plus is also set to true the player will use muted autoplay on macOS Safari 11+ whenever possible. Default: true.

srcChangeAutoplay: Boolean

When using the setSrc API method this setting allows to control the behaviour of player after srcchanged event has fired. When set to true this setting will cause content to autoplay just after srcchanged event. When set to false the player will remain in a pause state after srcchanged event. Default: true. When set to true this setting will only have effect after player has been initialised either through a valid user interaction or successful autoplay request. This setting is also compatible with playlist/related but when srcChangeAutoplay is set to false the playlistUpNextAutoplay and relatedUpNextAutoplay settings are automatically set to false.
Setting added with version 4.5.11

Autoplay API


This method returns a Boolean. It must be queried when the ready event fires to be relevant. If true is returned the player was started due to autoplay setting set to true (this applies to both autoplay with audio and muted autoplay - the player decides which autoplay mode it can use based on device capabilities - if autoplay is available). If false is returned the player was not started due to autoplay and will require an explicit interaction to start, for example a click/touch on the play/pause button or a call to the API play method. Note that this method does not state if autoplay was successful (user/device/plugin settings may block autoplay), it just reflects how the player was initially started. null is returned in case the value is not available.


This API event will fire when autoplay is set to true and autoplay of content or pre-roll ad was a success.


This API event will fire when autoplay is set to true and autoplay of content or pre-roll ad was a failure (likely due to an autoplay interference engine).

Autoplay policy for iframes

With the release of Chrome 65 autoplay of HTML5 video content in an iframe has been disabled by default. It must be enabled through autoplay feature policy. This change in autoplay policy for iframes means that an iframe holding an HTML5 video player needs to be explicitly allowed to autoplay by the parent window. This is the same in principle as what we have done in the past for allowing an iframe to go fullscreen. If you are using an iframe within an iframe then each iframe needs to be explicitly allowed to autoplay. Note that autoplay is allowed by default on same-origin iframes so enabling autoplay feature policy is only required for cross-origin iframe. Example:

  allow="autoplay; fullscreen"></iframe>

We have tested this set-up when Radiant Media Player is used in an iframe and can confirm this is generally working for Chrome 65+. It is likely other browsers will implement this feature as well in the near future. In case autoplay is blocked due to autoplay feature policy Radiant Media Player shall provide a play button so that playback can be initiated by a user gesture, in such case the autoplayfailure API event shall fire. You should also note the need to use the allowfullscreen attribute in complement to the allow attribute in order to support browsers that do not support allow attribute.

If you are using amp-iframe and autoplay you need to add allow="autoplay" to your amp-iframe element.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License.