Configuring Player Settings
This topic provides an overview of the player settings that can be configured using the legacy Players module.
Many of the player properties can also be set/changed dynamically by editing the player publishing code. For more information, check these related documents depending on whether you are using the Standard (iframe) or Advanced (in-page) embed code.
To configure the player settings, follow these steps:
- Click Players in the navigation header to open the Players module.
- Click the link for the player you want to configure.
- Locate the Settings section and click Edit or double-click in the section.
The following player settings can be configured:
- Update Mode and Player Version
- Activate Player
- Preload Video Before User Initiated Playback
- Auto-Start Video on Player Load
- Allow Fullscreen
- Show Quality Selector
- Display Playlist
- Auto Advance to Next Video
- Play On Select
- Playlist UI Version
- Aspect Ratio
- Player Dimensions
- Adjust Player Dimensions for Playlist
Note: Any changes made to a player may take up to 5 minutes to appear in published players.
Update Mode and Player Version
The Update Mode controls how player updates are handled. The Player Version is used to set the player version. For more information on these settings and how they should be used, see Setting the Player Update Mode and Version.
The Activate Player setting controls whether the player is activated and can be used to play content. Players that are activated can be used to playback content. Players that are not activated will not playback content. Default is Yes.
Preload Video Before User Initiated Playback
The Preload Video Before User Initiated Playback setting controls whether the player will preload video content before the user initiates playback.
The following options are available:
- Yes (higher bandwidth utilization, fastest video start) - Indicates that the whole video file could be downloaded, even if the user does not eventually watch the video. On the positive side, if the viewer plays the video, it can start playing immediately. On the negative side, this option will increase bandwidth consumption as the preload/load happens even if the viewer does not play the video.
- Load video metadata only (minimal preload of title, duration, etc.) - The video metadata is preloaded, along with a few seconds of video data. This is the default.
- No - None of the video is preloaded
Auto-Start Video on Player Load
The Auto-Start Video on Player Load setting controls whether the video will start playing when the player is loaded. Default is No.
Also note that autoplay is supported on Apple iOS devices only if muted used concurrently.
The Allow Fullscreen setting controls whether the viewer has the ability to resize the player to fill the entire monitor. When the video starts playing, a fullscreen icon will appear in the bottom right corner of the player. Default is Yes.
Show Quality Selector
The Show Quality Selector setting controls whether the viewer has the ability to manually select a different rendition as they are watching the video. When the video starts playing, a gear icon will appear in the bottom right corner of the player. Default is No.
Note: The quality selector requires Brightcove Player version 5.17.0 or newer and may not work with all browsers.
When this option is selected, two options for the Quality Selector Label will appear:
- Resolution (e.g., 720p) - Renditions will be displayed by lines of horizontal resolution
When using this option, another parameter (
resolutionLabelBitrates) can be added to the Quality Selection plugin to also display the bitrates.
This must be done by editing the plugin parameters as there is currently no way to configure this option using the Players module UI. For more information, see the Quality Selection Plugin document.
- HD/SD - The player will look at the bitrate information for each rendition to determine whether it is SD or HD
The Display Playlist setting controls whether videos in a playlist will be displayed on the right side of the player. This example shows a player with Display Playlist set to Enabled using the V2 Playlist Version. Default is Disabled.
Note: A maximum of 20 videos will be displayed when this option is selected.
Auto Advance to Next Video
The Auto Advance to Next Video setting controls whether the next video in the playlist will start playing when the current video finishes. This option is only visible if Display Playlist is Enabled. Default is Yes.
Play On Select
The Play On Select setting controls whether clicking a thumbnail in the playlist menu will cause the video to play when loaded, even if the previous video in the player was paused. This option is only visible if Display Playlist is Enabled. Default is Yes.
Playlist UI Version
The Playlist UI Version setting controls which version of the playlist UI is displayed. This option is only visible if Display Playlist is Enabled. Default is V2.
- V2 (Default) - Viewer clicks on the < control to display and hide the playlist
- V1 (Legacy) - The playlist is always displayed
Sizing can be set to Responsive or Fixed.
- Responsive - The player size will adjust automatically based upon the browser size
- Fixed - The player size is based upon the width and height parameters
Note: If you select the Responsive sizing option, the Standard (iframe) code works well and both the player and playlist are responsive. If you use the Advanced (in-page embed) code, the player will be responsive, but the playlist will not.
The Aspect Ratio sets the aspect ratio of the player.
- Custom - Enter values for both the player width and height
- 16:9 or 4:3 - Enter a player width and the height will be determined automatically
The Player Dimensions control the width and height of the player.
Adjust Player Dimensions for Playlist
The Adjust Player Dimensions for Playlist setting will modify the player size to accommodate the display of the playlist. This option is only visible if Display Playlist is Enabled and the Playlist Version is V1.