Once you've uploaded your video content and created players, you need to tie them together, so that the right player displays the right video content. Not all player templates permit you to assign playlists to them. If a player can't accept a playlist, it is labeled in the Media module "Publish videos to this player using Quick Publish or the Brightcove APIs." For information about assigning content to players in the Media module, see Assigning Content to Players using the Media Module and Quick Video Publishing.
To assign content to a player, you need to set parameters in the publishing code for the players, specifying the videos or playlists you want to play. You can use the ID or the reference ID to specify the videos or playlists, but you can't use both in the same publishing code. Here are two ways to look up the video ID for a video:
Once you have located the IDs for the videos or playlists you want to play back in the player, there are a few ways to assign them to your player. The method you choose depends on how you have published the player and how you need to control the content presented in the player. The syntax varies depending on the type of publishing code you have used. Read more about how to assign single videos or playlists with:
To pass the video ID to a player published using the JavaScript code, add the following parameter to your JavaScript publishing code:
<param name="@videoPlayer" value="12345" />
where "12345" is the video ID for the video to playback in the player.
The full HTML code used to publish the player and assign a video with ID "12345" to playback on load would be:
<script language="JavaScript" type="text/javascript" src=" http://admin.brightcove.com/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="486" /> <param name="height" value="412" /> <param name="playerID" value="1234567890" /> <param name="isVid" value="true" /> <param name="@videoPlayer" value="12345" /> </object>
To pass the reference ID to the player published using the JavaScript code, add the following parameter to your JavaScript publishing code:
<param name="@videoPlayer" value="ref:myVid12345" />
where "myvid12345" is the reference ID for the video to playback in the player. Note how you need to prepend ref: to your reference ID.
The full HTML code used to publish the player and assign a video with ID "12345" to playback on load would be:
<script language="JavaScript" type="text/javascript" src=" http://admin.brightcove.com/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="486" /> <param name="height" value="412" /> <param name="playerID" value="1234567890" /> <param name="isVid" value="true" /> <param name="@videoPlayer" value="ref:myVid12345" /> </object>
To pass a playlist ID to a player that accepts multiple playlists and that is published using the JavaScript code, add the playlistTabs or playlistCombo parameter to your JavaScript publishing code:
<param name="@playlistTabs" value="6789"/> <param name="@playlistCombo" value="6789"/>
where "6789" is the playlist ID for the playlist to playback in the player. Use the playlistTabs config parameter for players with tabbed playlist selection and the playlistCombo config parameter for players with combo box (dropdown) playlist selection. To pass more than one playlist ID, include each of the playlist IDs, separated by commas:
<param name="@playlistTabs" value="6789,9876,5432"/>
Players that get their content from a List or TabList component, such as the Widescreen with Horizontal List template, accept only a single playlist. To pass the playlist ID of a playlist to a player that accepts only a single playlist and that is published using the JavaScript code, add the videoList parameter to your JavaScript publishing code:
<param name="@videoList" value="6789"/>
The full HTML code used to publish the player and assign a playlist with ID 6789 to playback on load would be:
<script language="JavaScript" type="text/javascript" src="http://admin.brightcove.com/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="790" /> <param name="height" value="529" /> <param name="playerID" value="1234567890" /> <param name="isVid" value="true" /> <param name="isUI" value="true" /> <param name="@playlistTabs" value="6789" /> </object>
To pass the reference ID of a playlist to a player that accepts multiple playlists and that is published using the JavaScript code, add the playlistTabs or playlistCombo parameter to your JavaScript publishing code and prepend ref: to your reference ID in the parameter's value:
<param name="@playlistTabs" value="ref:myPlaylist6789"/> <param name="@playlistCombo" value="ref:myPlaylist6789"/>
where "myplaylist6789" is the reference ID for the playlist to playback in the player. To pass more than one playlist by reference ID, prepend ref: to a comma-separated list of the reference IDs of each of the playlists. Make sure there is no white space between the comma-separated items.
<param name="@playlistTabs" value="ref:myPlaylist6789,yourPlaylist9876,herPlaylist5432"/>
Players that get their content from a List or TabList component, such as the Widescreen with Horizontal List template, accept only a single playlist. To pass the reference ID of a playlist to a player that accepts only a single playlist and that is published using the JavaScript code, add the videoList parameter to your JavaScript publishing code and prepend ref: to your reference ID in the parameter's value:
<param name="@videoList" value="ref:myPlaylist6789"/>
The full HTML code used to publish the player and assign a playlist with reference ID myPlaylist6789 to playback on load would be:
<script language="JavaScript" type="text/javascript" src="http://admin.brightcove.com/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="790" /> <param name="height" value="529" /> <param name="playerID" value="1234567890" /> <param name="isVid" value="true" /> <param name="isUI" value="true" /> <param name="@playlistTabs" value="ref:myPlaylist6789" /> </object>
To pass the video ID to the player published with ActionScript, use the videoPlayer config parameter, like this:
config["@videoPlayer"] = "12345";
where "12345" is the video ID to playback in the player. Add this config parameter to the ActionScript publishing code for the player that you copied from the Publishing module.
To pass the reference ID of a video to the player published with ActionScript, use the videoPlayer config parameter and prepend ref: to your reference ID, like this:
config["@videoPlayer"] = "ref:myVideo12345";
where "myVideo12345" is the reference ID of the video to playback in the player. Add this config parameter to the ActionScript publishing code for the player that you copied from the Publishing module.
To pass the playlist ID to the player published with ActionScript, use the playlistTabs or playlistCombo config parameter, like this:
config["@playlistTabs"] = "6789"; config["@playlistCombo"] = "6789";
where "6789" is the playlist ID to playback in the player. Use the playlistTabs config parameter for players with tabbed playlist selection and the playlistCombo config parameter for players with combo box (dropdown) playlist selection. Add the config parameter to the ActionScript publishing code for the player that you copied from the Publishing module. To pass more than one playlist ID, include each of the playlist IDs, separated by commas:
config["@playlistTabs"] = "6789,9876,5432";
Players that get their content from a List or TabList component, such as the Widescreen with Horizontal List template, accept only a single playlist. To pass the playlist ID of a playlist to a player that accepts only a single playlist and that is published using the ActionScript code, add the videoList parameter to your ActionScript publishing code:
config["@videoList"] = "6789";
To pass the reference ID of a playlist to the player published with ActionScript, use the playlistTabs or playlistCombo config parameter and prepend ref: to your reference ID, like this:
config["@playlistTabs"] = "ref:myPlaylist6789"; config["@playlistCombo"] = "ref:myPlaylist6789";
where "myPlaylist6789" is the reference ID of the playlist to playback in the player. Add this config parameter to the ActionScript publishing code for the player that you copied from the Publishing module. To pass more than one reference ID, prepend ref: to a comma-separated list of the reference IDs. Make sure there is no white space between the comma-separated items.
config["@playlistTabs"] = "ref:myPlaylist6789,myPlaylist9876,myPlaylist5432";
Players that get their content from a List or TabList component, such as the Widescreen with Horizontal List template, accept only a single playlist. To pass the reference ID of a playlist to a player that accepts only a single playlist and that is published using the ActionScript code, add the videoList parameter to your ActionScript publishing code and prepend ref: to the reference ID of the playlist:
config["@videoList"] = "ref:myPlaylist6789";
To pass the video ID to the player embedded using HTML, add &@videoPlayer=12345 after the playerID in the HTML embed code, where "12345" is the video ID you wish to play back This must be added after both occurences of playerID in the embed code.
Sample HTML code to embed to force playback of a video with ID = 12345:
<object id="flashObj" width="486"
height="412" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,47,0">
<param name="movie" value="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1" />
<param name="bgcolor" value="#FFFFFF" />
<param name="flashVars" value="playerID=12345678900&@videoPlayer=12345&domain=embed&" />
<param name="base" value="http://admin.brightcove.com" />
<param name="seamlesstabbing" value="false" />
<param name="allowFullScreen" value="true" />
<param name="swLiveConnect" value="true" />
<param name="allowScriptAccess" value="always" />
<embed src="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1"
bgcolor="#FFFFFF" flashVars="playerID=12345678900&@videoPlayer=12345&domain=embed&"
base="http://admin.brightcove.com" name="flashObj" width="486"
height="412" seamlesstabbing="false" type="application/x-shockwave-flash"
allowFullScreen="true" swLiveConnect="true"
allowScriptAccess="always" pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">
</embed>
</object>
To pass the reference ID of a video to the player embedded using HTML, add &@videoPlayer=ref:myVideo12345 after the playerID in the HTML embed code, where "myVideo12345" is the video ID you wish to play back. This must be added after both occurences of playerID in the embed code.
To pass the playlist ID to the player embedded using HTML, add &@playlistTabs=6789 or &@playlistCombo=6789 after the playerID in the HTML embed code, where "6789" is the playlist ID you wish to playback. To pass more than one playlist ID, include each of the playlist IDs, separated by commas: &@playlistTabs=6789,9876,5432
If your player only accepts a single playlist, use the @videoList parameter instead: &@videoList=6789.
This must be added after both occurences of playerID in the embed code.
Sample HTML code to embed to force playback of a playlist with ID = 6789:
<object id="flashObj" width="486" height="412"
classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,47,0">
<param name="movie"
value="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1&isUI=1" />
<param name="bgcolor" value="#FFFFFF" />
<param name="flashVars" value="playerID=12345678900&@playlistTabs=6789&domain=embed&" />
<param name="base" value="http://admin.brightcove.com" />
<param name="seamlesstabbing" value="false" />
<param name="allowFullScreen" value="true" />
<param name="swLiveConnect" value="true" />
<param name="allowScriptAccess" value="always" />
<embed src="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1&isUI=1"
bgcolor="#FFFFFF" flashVars="playerID=12345678900&@playlistTabs=6789&domain=embed&"
base="http://admin.brightcove.com" name="flashObj"
width="486" height="412" seamlesstabbing="false"
type="application/x-shockwave-flash" allowFullScreen="true"
swLiveConnect="true" allowScriptAccess="always"
pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">
</embed>
</object>
To pass the reference ID of a playlist to a player embedded using HTML, add &@playlistTabs=ref:myPlaylist6789 or &@playlistCombo=ref:myPlaylist6789 after the playerID in the HTML embed code, where "myPlaylist6789" is the reference ID of the playlist you wish to playback. To pass more than one reference ID, prepend ref: to a comma-separated list of the reference IDs: &@playlistTabs=ref:myPlaylist6789,myPlaylist9876,myPlaylist5432. Make sure there is no white space between the comma-separated items.
If your player only accepts a single playlist, use the @videoList parameter instead: &@videoList=ref:myVideo6789.
This must be added after both occurences of playerID in the embed code.
You can include the video ID in the URL to a Brightcove-hosted player by appending ?bctid=12345 to the Player URL, where "12345" is the video ID you wish to playback. For example:
http://link.brightcove.com/services/player/bcpid0789?bctid=12345
If you are hosting the player using the JavaScript code on your own site, you can also modify the URL to force playback of a particular video. Append ?bctid=12345 to the URL where you are hosting the player, where "12345" is the video ID you wish to playback. For example:
http://www.myexamplesite.com/playerpage.html?bctid=12345
You can include the playlist ID in the URL to the Brightcove-hosted player by appending ?bclid=6789 to the Player URL, where "6789" is the video ID you wish to playback. For example:
http://link.brightcove.com/services/player/bcpid0789?bclid=6789
Note that you cannot use this approach to include multiple playlists in a player.
If you are hosting a player using the JavaScript code on your own site, you can also modify the URL to force playback of a particular video. Append ?bclid=6789 to the URL where you are hosting the player, where "6789" is the playlist ID you wish to playback. For example:
http://www.myexamplesite.com/playerpage.html?bclid=6789