When you assign a video or a playlist to a player, you can designated it as featured content. This means that the designated video or playlist will always be the first one to play in that player and will be the first one listed in the player's tabs or video lists. Designate a featured video or playlist by adding .featured to the video ID or playlist ID parameter. This works whether you have assigned content through the Media module or by modifying the publishing code.
For example, suppose you have a player with three playlists assigned, using this parameter:
<param name="@playlistTabs" value="1234,1235,1236" />
You can also specifiy which of those playlists will be loaded and displayed initially using the following notation:
<param name="@playlistTabs.featured" value="1235" />
This would select the second playlist, 1235, and display its videos first in the list.
In either case, if the specified playlist is not already in the player's list of included playlists, it will be prepended to the list. For example, suppose you had playlists with the IDs 1234, 1235 and 1236 programmed (or specified in the publishing code), and then added this line:
<param name="@playlistTabs.featured" value="4321" />
This new playlist would appear first in the tabs and have its videos displayed first.
In addition, if you wish to cue up a specific video in the featured playlist upon load, you can do so with the following notation:
<param name="@videoList.featured" value="3333" />
If this video appears in the selected playlist, it will be selected and sent to the video player ready for playback.
All of the following scenarios are valid. Whether the initial collection of playlists is set through the publishing code or programmed through the Media module, the results are the same:
<param name="@playlistTabs" value="1234,1235,1236" /> <param name="@playlistTabs.featured" value="1235" />
Selects the second playlist on load.
<param name="@playlistTabs" value="1234,1235,1236" /> <param name="@playlistTabs.featured" value="4321" />
Prepends the featured playlist to the collection displayed on load and selects it. The total number of playlists would be four.
<param name="@playlistTabs" value="1234,1235,1236" /> <param name="@playlistTabs.featured" value="1235" /> <param name="@videoList.featured" value="3333" />
Selects the second playlist by default and selects the video with the id 3333 if it is found (or defaults to the first video if it is not found).
<param name="@playlistTabs" value="1234,1235,1236" /> <param name="@playlistTabs.featured" value="4321" /> <param name="@videoList.featured" value="3333" />
Prepends the featured playlist to the collection displayed on load and selects it. The total number of playlists would be four. This example also selects the video with the id 3333 if it is found in that playlist (or defaults to the first video if it is not found).
<param name="@playlistTabs" value="1234,1235,1236" /> <param name="@videoList.featured" value="3333" />
Since no playlist is selected as featured, the first playlist will display by default. If the video with the id 3333 is found within that playlist, it is selected.
This all applies to ActionScript as well as HTML. The only difference is that in ActionScript publishing code, you use config[param] instead of <param name="name" value="value"> to pass the values. The ActionScript notation is:
config["@playlistTabs.featured"] = 1234;