Overview

Known limitations mainly result from feature compatibility issues across different devices and browsers.

Autoplay limitations

Some browsers, such as Chrome and Safari, block autoplaying video with sound. While blocking algorithms are complex, exceptions exist. For example, Chrome might allow autoplay with sound on frequently visited sites.

The Video plugin checks for browser autoplay support and then plays the ad either with sound or muted. In most cases, if the browser blocks autoplay with sound, the following behavior applies:

• If the content player has the autoplay option activated, the ad plays without sound (muted).
• If the content player's autoplay option is off and the user must click to start the video, the first ad matches the volume of the content player. If the player is muted, the ad is muted. If the content plays with sound, the ad plays with sound.

The Video plugin can't configure settings for the content player. Ensure your content player is muted if it uses autoplay on the browsers mentioned previously.

Native player limitations

The following limitations apply to specific mobile devices:

• iPhone devices: If the content video can't play in inline mode and must use the native player (fullscreen mode), no elements can be displayed over the player. Consequently, mid-rolls, overlays, custom controls, and click-throughs aren't supported.
• iPad devices: Equativ has removed the fullscreen button from custom ad controls on iPad. When the native iOS video player (Quicktime) uses fullscreen mode, elements, such as click-through areas, custom controls, skip buttons, and labels can't be displayed over the player.
  iPad implementations use two separate <video> tags (content player and ad player), and ads can't play in fullscreen mode only.
  Mid-rolls aren't supported. Only pre-rolls and post-rolls are available. The user experience of mid-rolls would be degraded because you would have to leave fullscreen mode prior to playing the ad and because the fullscreen mode for the following linear ad can't be enforced.

Fullscreen mode limitations

The Equativ HTML5 Video plugin supports two implementation modes:

• Shared tag: The ad and content player share the same <video> tag (iPhone only).
• Separate tags: A separate <video> tag is created for ads, displaying the Video plugin above the content player.

When using default controls in the main content <video> tag, clicking the fullscreen button only applies fullscreen mode to the content <video> tag. This prevents the Video plugin from displaying over the player. To resolve this, use custom controls to apply fullscreen mode to a common parent DOM element. This is called seamless fullscreen.

The following example shows a DOM element structure for JW Player using the Video plugin with seamless fullscreen:

<div id='the_div_id'></div> <!-- Main container -->

jwplayer('the_div_id').setup({some parameters});
sas_adplayer.registerPlayer('the_div_id');

This results in the following structure:

<div id='the_div_id'> <!-- Main container -->
  <div> <!-- JW Player container -->
    <span>
      <span>
        <video></video> <!-- Content video player -->
      </span>
      <span>...</span> <!-- Controls apply fullscreen to 'the_div_id' -->
    </span>
  </div>
  <div> <!-- Main ad container -->
    <div></div>
    <video></video>
    <div></div> <!-- Controls apply fullscreen to 'the_div_id' -->
    <div></div>
    <div></div>
  </div>
</div>

In the plugin configuration, set the html5SeamlessFullscreen variable to notify the Video plugin that your content player supports seamless fullscreen. For more information, see “Configure publisher” in Video plugin: configure and customize.