Specifying Metadata
You can use the clientData element to add information about the content to the Content Description Context passed by the server to the client. The clientData element uses custom-defined name/value pairs to pass data to the client. Windows Media Player uses the content description list to display the name of the author, copyright information and so on. The content description context for a media file or stream contains all of the clientData attributes for that media element and all parent elements. When the parent and child elements contain the same attribute, the attribute value for the parent takes precedence.
Note
Only Windows Media Player 9 Series supports this feature.
The following example illustrates use of the clientData element.
<?wsx version="1.0"?>
<smil>
<media id=" m1" role="m1" src="c:\wmpub\wmroot\movie1.wmv">
<clientData album="album_name_1" artist="artist_name_1"
author="author_name_1" CopyRight="copyright_info_1"
Genre="genre_info_1" Title="title_1" />
</media>
<media id=" m2" role=" m2" src="c:\wmpub\wmroot\movie2.wmv">
<clientData album="album_name_2" artist="artist_name_2"
author="author_name_2" CopyRight="copyright_info_2"
Genre="genre_info_2" Title="title_2" />
</media>
</smil>
The following table identifies clientData values supported by Windows Media Services.
Attribute name |
Description |
Equivalent client-side playlist element |
|---|---|---|
album |
Specifies the album name. |
Not Applicable |
artist |
Specifies the name of the artist. |
Not Applicable |
author |
Specifies the author of the playlist or of the media file. |
AUTHOR |
bannerAbstract |
Specifies the text displayed as a tool tip for the banner image pointed to by the bannerURL attribute. |
ABSTRACT |
bannerInfoURL |
Specifies the URL accessed by clicking on the banner image pointed to by the bannerURL attribute. |
MOREINFO |
bannerURL |
Specifies the URL for a graphic image that you can display in a Windows Media Player display panel. The banner graphic is displayed only with audio-only streams and files. Windows Media Player reserves a 32x194 pixel display area for the graphic. If the graphic is larger than the space reserved, Windows Media Player crops the image to fit. |
BANNER |
copyright |
Specifies the copyright information. |
COPYRIGHT |
genre |
Specifies the genre of the playlist or media file. |
Not Applicable |
logURL |
Specifies the URL that is used to post logging statistics. |
LOGURL |
title |
Specifies the name of the playlist or media file. |
Not Applicable |