On This Page

Opting Out of Automatic Player Updates

This topic explains how to opt out of automatic player updates, as well as setting a player to a specific version.

Note: This document uses curl statements to perform operations using the Player Management API. In the curl statements you will see values of $EMAIL, $ACCOUNT_ID and $PLAYER_ID. You must either create environment variables by those names and assign corresponding values, or supply the literal values for the variables.

Automatic player updates

By default Brightcove automatically updates all players on a regular basis so that they can take advantage of new features and fixes without any effort required from our customers. While Brightcove does not recommend opting out of updates in most cases, Brightcove realizes that from time to time some customers would prefer that your players remain completely untouched (for instance, you have done rigorous testing in preparation for a big event and you don’t want to risk anything changing).

Opting out of auto-updates

If you find the need to opt out of player updates for a period of time, the simplest way is by applying a PATCH to your player’s configuration. The following curl statement performs this task:

This adds the locked setting to your preview player. The PATCH initially affects only your preview player, so you need to publish your player. You could do this in Studio or using the following curl statement:

This will update your preview player to the current player template version if it is different from what you currently have. You should test with the preview player URL that is returned by this call to ensure that your player still functions as expected. Once satisfied you then publish the player to make the new player go live:

Switch to specific version

You may wish to switch your player to a specific version. You may be opting out of updates, but want to use some specific version that came after you opted out of updates. To do this: use the following curl statement, of course substituting the specific version of the player you want: