Share via


mediaName

banner art

Previous Next

mediaName

You can use the mediaName attribute to hide content path information from end users. The value assigned to the mediaName attribute is passed to the client in the content descriptor list instead of the value specified for the src attribute. The value is also used by a logging plug-in to fill in the media name field in a log file.

  • Note   This attribute is available only for Windows Media Player 9 Series and later.

Syntax

  mediaName= String-value

Remarks

This attribute is a Microsoft extension to SMIL 2.0.

The WMS SMIL Playlist Parser plug-in enforces case sensitivity on the mediaName attribute.

When Windows Media Player receives content from a server-side playlist, it submits a log to the server to identify that it has switched to a new entry. The server raises a WMS_EVENT_LOG event notice that can be handled by any enabled logging plug-in. The plug-in can retrieve information from the appropriate context and save it in the fields of a log file. For example, the plug-in can log the name of the playlist entry in the cs-media-name field. By default, the cs-media-name field contains the file name of the playlist entry, but an administrator can override this by using the mediaName attribute. This is demonstrated by the following example.

<?wsx version="1.0"?>
<smil>
    <media src="c:\wmpub\wmroot\IntroClip.wmv" />
    <media src="c:\wmpub\wmroot\MovieClip.wmv" mediaName="Movie" />
</smil>

In the log file, the cs-media-name for the first player will be "IntroClip.wmv", but for the second playlist entry, the cs-media-name field will be "Movie".

You can use the mediaName attribute to increase security. Because playlist entries and log file information are sent unecrypted, using mediaName prevents discovery of the physical location of content.

  • Note    You cannot use restricted XML characters such as "&" or "<" in the name of the media element. You must instead use an entity reference such as &amp or &lt. For more information, see XML Entity References.

See Also

Previous Next