Brightcove Player Migration Guide

Product(s)
Video Cloud
Role(s)
Studio User
Topic(s)
Legacy Migration

This topic offers information and guidance on migrating from the Flash-based Smart Player to the new Brightcove Player.

The new Brightcove Player is recommended for most Video Cloud customers, but you can continue to use the Flash-based Smart Player. You can try the new Brightcove Player without disrupting any of your existing player sites or pages, and you can choose to update them one at a time or all at once - however you like.

Note: For a version of this document that is focused on developers, see the Video Cloud developer documentation.

This topic is organized into the following sections that address different player features and how they are implemented using the Brightcove Player.

Advertising

With Smart Players, advertising can be configured at the video and player level. With the Brightcove Player, ads are configured at the player level. Advertising can be configured using the Players module or by configuring the IMA or FreeWheel plugins manually.

Bumpers

With Smart Players, bumper videos can be configured for videos and players using the legacy Video Cloud Studio. Bumpers are not supported using the new Video Cloud Studio and Brightcove Player. It is possible to simulate the bumper functionality programmatically using playlists. See this developer code sample for more information.

Captions

With Smart Players, captions must be in DFXP format. With Brightcove Players, captions must be in WebVTT format. With both players, captions can be hosted by Brightcove or reside on a remote URL. For information, see Adding Captions to Videos using the Media Module.

Note: There are online resource available that can convert caption formats. If you are using 3PlayMedia to generate caption files, they can convert all your caption files for you.

Player Endscreen

With Smart Players, the player endscreen can be customized by setting player properties. The same is true for Brightcove Players. For information, see Configuring the Player Endscreen.

With Smart Players, logo overlays can be configured for videos and at the account level. With Brightcove Players, overlays are configured in the Players module using the overlay plugin. For information on working with the overlay plugin, see this developer document.

Player Availability

Player Availability consists of domain restrictions and geographic filtering:

  • Domain Restrictions - Restricts player use to specific domain(s)
  • Geographic Filter (or Geofiltering) - Restricts access to video content based on the viewer's geographic location. With Smart Players you could set geo-restriction at the player level and the video level. With Brightcove Players, geofiltering can only be set for videos as part of the video properties.

Both of these settings are configured using the Players module in the new Video Cloud Studio. For information, see Configuring Player Content Restrictions.

Player Language

With Smart Players, the player language can be set as part of the player properties. There is no language setting that can be set in the new Video Cloud Studio to control the player language. If you wish to change the player language, see this developer document.

Player Plugins

If you have any Smart Players that have player plugins, you will need to re-create these plugins for the new Brightcove Player. The new Brightcove Player has a new extension and customization model based on JavaScript and CSS. Player plugins are now registered using the Players module in Video Cloud Studio. You can also create your own plugins to change UI behavior, including player controls, overlays, menus, and integration with third-party tools.

Player Styling

Basic player styling is done using the Players module in the new Video Cloud Studio. For information, see Styling Players.

If you have created custom Smart Players or customized any players using BEML, you will need to re-create these customizations for the new Brightcove Player. Smart Player customization will not work with the new Brightcove Player. The new Brightcove Player has a new extension and customization model based on JavaScript and CSS. Plugins can be written to change UI behavior, including player controls, overlays, menus, and integration with third-party tools.

Playlists

Playlists can be displayed in both Smart Players and Brightcove Players. When creating a Smart Player, a player template that supports playlists is selected. With Brightcove Players, playlist support is added by setting some player properties. Currently, Brightcove Players can display a single playlist vertically, to the right of the player. For information, see Publishing Videos and Playlists with the Media Module.

Social Sharing

Smart Players allow you to add social sharing features to your player but they are limited to Facebook and Twitter. The Brightcove Player offers a broader range of social sharing platforms including Facebook, Twitter, Google+, Tumblr, Pinterest, and LinkedIn. For information, see Configuring the Social Properties for a Player.

Video Renditions

The Brightcove player is optimized for HLS playback, and that is the preferred format for videos, though others are supported. We recommend that you have a good set of HLS renditions for videos you want to publish using the new player. The best option is to replace older videos using the Upload Module and one of the new ingest profiles.