Player V4 Plugins

Player V4 is a modular player consisting of plugins, which means that you can add or remove certain player functionality depending on which plugins you load on your HTML page. Some plugins are required for your player to function and other plugins are optional, depending on what functionality you want your player to have. For details on the default location of these plugins, see Ooyala-hosted Player V4 Resources.

Note: Plugins must all be from the same Player V4 version. Mixing versions is not recommended.
Important: If you use Backlot to generate your HTML embed code, and you choose the V4 HTML5 Standard Player Embed Code (recommended) option, certain plugins are automatically included and should not be explicitly added to the web page where you launch the player. For details, see Configuring Player Embed Settings in Backlot.

Required Plugins

Required plugins include:
  • Core player (core.min.js)
  • At least one video plugin:
    • Bitmovin plugin for DASH and HLS (bit_wrapper.min.js)
    • HLS and MP4 Main video plugin (main_html5.min.js)
    • Ooyala Player Plugin for YouTube iFrame (youtube.min.js)
    • OSMF Flash plugin for HDS (osmf_flash.min.js) (Deprecated)
      Note: The OSMF Flash Video Plugin for HDS for Player V4 has been deprecated and is scheduled to be disabled. For details and alternatives, see the OVP Release Notes.
    • Akamai HD video plugin for Akamai packaged HDS (akamaiHD_flash.min.js) (Deprecated)
      Note: The Akamai HD Video Plugin for Akamai Packaged HDS for Player V4 has been deprecated and is scheduled to be disabled. For details and alternatives, see the OVP Release Notes.

See Flash Video Rendering for details on Flash video rendering.

Optional Plugins

Optional plugins include:

Plugin Best Practices

The following are best practices for using the video plugins.
  • You must load the Core Player and at least one video plugin for Player V4 to function properly.
  • Generally, when using the bit_wrapper.min.js plugin, you should always load it first, before the other video plugins.
  • You cannot use the bit_wrapper.min.js plugin with iOS. Please note that you can still include this plugin on the page (it just won’t do anything). This means that you don’t have to change which plugins you load based on device.
  • To support FreeWheel ad playback, you must include the main_html5.min.js plugin.
  • To support VPAID ad playback, you must load the main_html5.min.js plugin first among the video plugins.
  • The osmf_flash.min.js plugin does not currently support Google IMA Ad Rules.
  • For DASH streams on desktop web, we recommend using the bit_wrapper.min.js plugin with Chrome.
  • For MP4 streams, we recommend using the main_html5.min.js plugin.
  • If you would like to use HLS streams on desktop, we recommend that you use our bit_wrapper.min.js plugin on Chrome, Firefox and Internet Explorer. For Safari and Edge we encourage you to use the main_html5.min.js plugin instead.
  • The main_html5.min.js plugin does not report bitrate information. If you want to track bitrate information (see Analytics in Player V4), you must use the the Bitmovin plugin for DASH and HLS, OSMF Flash plugin for HDS (Deprecated), or the Akamai HD video plugin for Akamai packaged HDS (Deprecated).

Stream Support per Browser

Note: The OSMF and Akamai plugins (deprecated) allow backwards compatibility with existing HTTP Dynamic Streaming (HDS) and Akamai HDS (or HD2) assets. However, HDS and HDS2 use a Flash component, and browsers will soon be disabling the Flash plugin. Going forward, Ooyala strongly recommends that customers encode and use HLS and Dash instead. This may involve re-encoding existing assets where possible. Given industry changes and the increased importance of mobile playback, we expect to deprecate support for Flash-based formats (such as HDS and HD2) soon. Customers should consider these as legacy formats that are being phased out over time.

Desktop Web Stream and Browser Support

The following table shows which Ooyala video plugin to load for each stream type and browser for desktop web players.
Note: The OSMF Flash Video Plugin for HDS for Player V4 has been deprecated and is scheduled to be disabled. For details and alternatives, see the OVP Release Notes.
Note: The Akamai HD Video Plugin for Akamai Packaged HDS for Player V4 has been deprecated and is scheduled to be disabled. For details and alternatives, see the OVP Release Notes.
Browser HLS and eHLS DASH MP4 HDS (Deprecated)
Chrome v47+ bit_wrapper.min.js bit_wrapper.min.js bit_wrapper.min.js or main_html5.min.js osmf_flash.min.js (Deprecated) or akamaiHD_flash.min.js for Akamai packaged HDS (Deprecated)
Safari v8+ bit_wrapper.min.js or main_html5.min.js bit_wrapper.min.js (remote and local assets supported in Player v4.3.3+) bit_wrapper.min.js or main_html5.min.js osmf_flash.min.js (Deprecated) or akamaiHD_flash.min.js for Akamai packaged HDS (Deprecated)
Firefox v43+ bit_wrapper.min.js bit_wrapper.min.js bit_wrapper.min.js or main_html5.min.js osmf_flash.min.js (Deprecated) or akamaiHD_flash.min.js for Akamai packaged HDS (Deprecated)
Internet Explorer v11(1) bit_wrapper.min.js bit_wrapper.min.js bit_wrapper.min.js or main_html5.min.js osmf_flash.min.js (Deprecated) or akamaiHD_flash.min.js for Akamai packaged HDS (Deprecated)
Microsoft Edge bit_wrapper.min.js or main_html5.min.js bit_wrapper.min.js bit_wrapper.min.js or main_html5.min.js osmf_flash.min.js (Deprecated) or akamaiHD_flash.min.js for Akamai packaged HDS (Deprecated)
Note: (1)HLS and eHLS are supported only on Windows 8+.

Mobile Web Stream and Browser Support

The following table shows which Ooyala video plugin to load for each stream type and browser for mobile web players.
Browser HLS and eHLS DASH MP4
Android v4.1 and v4.3+ Chrome
iOS v8+ Safari Not supported

Stream Options

Note: The HTTP Dynamic Streaming (HDS), including Akamai HDS (or HD2) streaming protocol, use Flash. Browsers have been disabling and blocking the Flash plugin. As a result, Ooyala strongly recommends that customers encode and use HLS and Dash moving forward.
Device Supported Streams Recommended Stream Supported Player V4 Plugins
Desktop MP4, HLS, eHLS, HDS (Deprecated), DASH HLS
Android Web MP4, HLS, eHLS, DASH DASH
iOS Web MP4, HLS, eHLS HLS
Android App MP4, HLS, eHLS, DASH HLS or DASH N/A - use the mobile SDK for Android
iOS App HLS, eHLS, MP4 HLS N/A - use the mobile SDK for iOS
Note: Player V4 is not supported on Xbox, Roku, Amazon Fire TV, Connected/Smart TVs, or Chromecast devices for this release.

Deciding Which Plugins to Load

The following table shows which plugins you should load given your specific use case:
If you want to... Load the following in your HTML page...
Load a V4 player without the Ooyala skin
  • Core player (core.min.js)
  • At least one video plugin
    • Bitmovin plugin for DASH and HLS (bit_wrapper.min.js)
    • HLS and MP4 Main video plugin (main_html5.min.js)
    • OSMF Flash plugin for HDS (osmf_flash.min.js) (Deprecated)
    • Akamai HD video plugin for Akamai packaged HDS (akamaiHD_flash.min.js) (Deprecated)

See Examples of Player V4 Web Page Embedding for a general implementation example.

See Flash Video Rendering for details on Flash video rendering.

Load a V4 player with the Ooyala skin
  • Core player (core.min.js)
  • At least one video plugin
    • Bitmovin plugin for DASH and HLS (bit_wrapper.min.js)
    • HLS and MP4 Main video plugin (main_html5.min.js)
    • OSMF Flash plugin for HDS (osmf_flash.min.js) (Deprecated)
    • Akamai HD video plugin for Akamai packaged HDS (akamaiHD_flash.min.js) (Deprecated)
  • HTML5 skin plugin (html5-skin.min.js)
  • Skin CSS (html5-skin.min.css)
  • Skin customization file (skin.json)

See Examples of Player V4 Web Page Embedding for a general implementation example and Customizing the Player V4 Appearance for details on how to customize your player.

Load a V4 player with the Ooyala skin and Ooyala Pulse ad functionality
  • Core player (core.min.js)
  • At least one video plugin
    • Bitmovin plugin for DASH and HLS (bit_wrapper.min.js)
    • HLS and MP4 Main video plugin (main_html5.min.js)
    • OSMF Flash plugin for HDS (osmf_flash.min.js) (Deprecated)
    • Akamai HD video plugin for Akamai packaged HDS (akamaiHD_flash.min.js) (Deprecated)
  • HTML5 skin plugin (html5-skin.min.js)
  • Skin CSS (html5-skin.min.css)
  • Skin customization file (skin.json)
  • Ooyala Pulse ad plugin (pulse.min.js)
Note: If you are using the Freewheel, VAST, or Google IMA ad plugins, you can load multiple ad plugins on a page (Integrating Multiple Ad Managers). Otherwise, you can load only one ad plugin per player (at a time).

See Integrating Ooyala Pulse Ads for an implementation example.

Load a V4 player with the Ooyala skin and FreeWheel ad functionality
  • Core player (core.min.js)
  • At least one video plugin
    • Bitmovin plugin for DASH and HLS (bit_wrapper.min.js)
    • HLS and MP4 Main video plugin (main_html5.min.js)
    • OSMF Flash plugin for HDS (osmf_flash.min.js) (Deprecated)
    • Akamai HD video plugin for Akamai packaged HDS (akamaiHD_flash.min.js) (Deprecated)
  • HTML5 skin plugin (html5-skin.min.js)
  • Skin CSS (html5-skin.min.css)
  • Skin customization file (skin.json)
  • FreeWheel ad plugin (freewheel.min.js)
Note: If you are using the Freewheel, VAST, or Google IMA ad plugins, you can load multiple ad plugins on a page (Integrating Multiple Ad Managers). Otherwise, you can load only one ad plugin per player (at a time).

See Integrating FreeWheel Ads for an implementation example.

Load a V4 player with the Ooyala skin and VAST and/or VPAID ad functionality
  • Core player (core.min.js)
  • At least one video plugin
    • HLS and MP4 Main video plugin (main_html5.min.js)
    • OSMF Flash plugin for HDS (osmf_flash.min.js) (Deprecated)
    • Bitmovin plugin for DASH and HLS (bit_wrapper.min.js)
    • Akamai HD video plugin for Akamai packaged HDS (akamaiHD_flash.min.js) (Deprecated)
  • HTML5 skin plugin (html5-skin.min.js)
  • Skin CSS (html5-skin.min.css)
  • Skin customization file (skin.json)
  • VAST and VPAID ad plugin (ad_manager_vast.min.js)
Note: If you are using the Freewheel, VAST, or Google IMA ad plugins, you can load multiple ad plugins on a page (Integrating Multiple Ad Managers). Otherwise, you can load only one ad plugin per player (at a time).

See Integrating VAST and VPAID Ads for an implementation example.

Load a V4 player with the Ooyala skin and Google IMA ad functionality
  • Core player (core.min.js)
  • At least one video plugin
    • Bitmovin plugin for DASH and HLS (bit_wrapper.min.js)
    • HLS and MP4 Main video plugin (main_html5.min.js)
    • OSMF Flash plugin for HDS (osmf_flash.min.js) (Deprecated)
    • Akamai HD video plugin for Akamai packaged HDS (akamaiHD_flash.min.js) (Deprecated)
  • HTML5 skin plugin (html5-skin.min.js)
  • Skin CSS (html5-skin.min.css)
  • Skin customization file (skin.json)
  • Google IMA ad plugin (google_ima.min.js)
Note: If you are using the Freewheel, VAST, or Google IMA ad plugins, you can load multiple ad plugins on a page (Integrating Multiple Ad Managers). Otherwise, you can load only one ad plugin per player (at a time).

See Integrating Google IMA Ads for an implementation example.

Load a V4 player with the Ooyala skin and Ooyala Discovery functionality
  • Core player (core.min.js)
  • At least one video plugin
    • Bitmovin plugin for DASH and HLS (bit_wrapper.min.js)
    • HLS and MP4 Main video plugin (main_html5.min.js)
    • OSMF Flash plugin for HDS (osmf_flash.min.js) (Deprecated)
    • Akamai HD video plugin for Akamai packaged HDS (akamaiHD_flash.min.js) (Deprecated)
  • HTML5 skin plugin (html5-skin.min.js)
  • Skin CSS (html5-skin.min.css)
  • Skin customization file (skin.json)
  • Discovery plugin (discovery_api.min.js)

See Examples of Player V4 Web Page Embedding for a general implementation example.

Was this article helpful?