christophedelory.playlist.wpl
Class Media

java.lang.Object
  christophedelory.playlist.wpl.Media

public class Media
extends Object

Specifies one of the media items in a playlist.
Windows Media Player 9 Series or later.

Version:

$Revision: 92 $

Author:

Christophe Delory

Constructor Summary

Media()

Method Summary

String	getContentId() Returns the content ID (WPL GUID) that is unique to this media item.
String	getSource() Returns the URL of this media item, as a string.
String	getTrackingId() Returns the tracking ID (WPL GUID) that can be used to track the File System Object for this media item.
void	setContentId(String cid) Initializes the content ID that is unique to this media item.
void	setSource(String source) Initializes the URL of this media element from the specified string.
void	setTrackingId(String tid) Initializes the tracking ID that can be used to track the File System Object for this media item.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Media

public Media()

Method Detail

getSource

public String getSource()

Returns the URL of this media item, as a string.

Returns:

an URL. May be null if not yet initialized.

See Also:

setSource(java.lang.String)

setSource

public void setSource(String source)

Initializes the URL of this media element from the specified string.

Parameters:

source - an URL. Shall not be null.

Throws:

NullPointerException - if source is null.

See Also:

getSource()

getContentId

public String getContentId()

Returns the content ID (WPL GUID) that is unique to this media item. The cid attribute (the content ID) is populated by the Windows Media Player as a way to uniquely identify a piece of media content even if its metadata attributes have been changed. This allows the sharing of playlists across computers, because the content can be identified on another computer, and the path to it can be "auto-repaired" by the Windows Media Playlist.

Returns:

the content ID. May be null.

See Also:

setContentId(java.lang.String)

setContentId

public void setContentId(String cid)

Initializes the content ID that is unique to this media item.

Parameters:

cid - the content ID. May be null.

See Also:

getContentId()

getTrackingId

public String getTrackingId()

Returns the tracking ID (WPL GUID) that can be used to track the File System Object for this media item. The tid attribute (the tracking ID) uses the Windows file system to auto-repair the path to the media if the name or location of the file is changed.

Returns:

the tracking ID. May be null.

See Also:

setTrackingId(java.lang.String)

setTrackingId

public void setTrackingId(String tid)

Initializes the tracking ID that can be used to track the File System Object for this media item.

Parameters:

tid - the tracking ID. May be null.

See Also:

getTrackingId()