Version: 2.67.0

FAQ | How to combat autoplay policies

Introduction

This short article explains what autoplay is, where autoplay is restricted, and what THEOplayer does to facilitate working with autoplay.

Autoplay

When you enable autoplay for a HTML5 video, you instruct the viewer's browser to automatically play the content as soon as possible without action from the viewer.

Restrictions

Browsers are restricting their autoplay capabilities. These policies are the result of the continuous misuse of autoplay which causes bad user experiences.

There are two types of autoplay:

  1. Unmuted Autoplay: autoplay with audio enabled.
  2. Muted Autoplay: autoplay with audio disabled.

The first type is considered more abruptive, while the second type is considered more user-friendly. Some browsers which normally disallow unmuted autoplay allow it when the viewer explicitly indicates so*.

As of October 2017, the following autoplay policies are in place:

| Operating System | Browser | Type | Allowed | |  iOS | Safari 11  | Unmuted Autoplay  | No  | |   |   | Muted Autoplay | Yes  | |  Android | Chrome  | Unmuted Autoplay  | No  | |   |   |  Muted Autoplay | Yes  | |  MacOS | Safari 10  | Unmuted Autoplay | Yes  | |   |   | Muted Autoplay | Yes | |   | Safari 11 | Unmuted Autoplay | No | |   |   | Muted Autoplay | Yes | | Windows, MacOS | Chrome 64 | Unmuted Autoplay | No | Windows, MacOS | Chrome 64 | Muted Autoplay | Yes

API

An HTML5 video player can't circumvent these technical limitations, but it can offer an API which enables you in a smart way to switch between muted and unmuted autoplay.

THEOplayer has the mutedAutoplay property in the PlayerConfiguration. When you set this property to all, THEOplayer will run in unmuted autoplay on browsers where this is allowed, and in muted autoplay where autoplay with sound is not allowed. You can find a valid example below:

// ...
var player = new THEOplayer.Player(element, {
// ...
mutedAutoplay: 'all',
// ...
});
// ...
player.autoplay = true;
// ...

There's a possibility that new restrictions will be introduced in the future, so it's advised to keep autoplay restrictions in mind when developing your product.