Share via


ServiceInfo Document

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note

This section describes functionality designed for use by online stores. Use of this functionality outside the context of an online store is not supported.

Online stores must author the ServiceInfo.xml document. This is the document that the online store uses to configure the Windows Media Player user interface when Windows Media Player 10 or later is hosting the online store.

The following elements and their attributes are supported for Windows Media Player online stores.

Element Description
AlbumInfo Specifies the URL for the webpage that Windows Media Player displays when the user chooses to view more information about a particular media item.Type 1: optional
Type 2 Music: required
Type 2 Commerce: ignored
ButtonText Specifies the text string that Windows Media Player displays for a task pane button.Type 1: required
Type 2 Music: required
Type 2 Commerce: required
ButtonTip Specifies the tooltip that is displayed when the user points to a task pane button.Type 1: optional
Type 2 Music: optional
Type 2 Commerce: optional
BuyCD Specifies the URLs for webpages that Windows Media Player displays when the user chooses to make a purchase.Type 1: required
Type 2 Music: required
Type 2 Commerce: ignored
Color Specifies the background color for online stores navigation buttons.Type 1: optional
Type 2 Music: optional
Type 2 Commerce: optional
Description Specifies a description of the online store that is displayed during the user's first experience with an installation of Windows Media Player. Requires Windows Media Player 11.Type 1: required
Type 2 Music: optional
Type 2 Commerce: optional
DownloadStatus Specifies a URL that the Windows Media Player displays as a link to enable users to view download status.Type 1: ignored
Type 2 Music: optional
Type 2 Commerce: optional
FriendlyName Specifies the text string that Windows Media Player displays to the user to identify the online store.Type 1: required
Type 2 Music: required
Type 2 Commerce: required
HTMLView Specifies the base URL of an HTMLView webpage.Type 1: optional
Type 2 Music: optional
Type 2 Commerce: optional
Image Specifies the images that Windows Media Player displays to the user to represent the online store.Type 1: required
Type 2 Music: optional
Type 2 Commerce: optional
InfoCenter Specifies the URL of the webpage that Windows Media Player displays in the Info Center View feature of Now Playing when the online store is active.Type 1: required
Type 2 Music: required
Type 2 Commerce: ignored
Install Specifies values used by Windows Media Player setup to install the default online store.Type 1: required
Type 2 Music: optional
Type 2 Commerce: ignored
Navigate Specifies a base URL used by calls to External.NavigateTaskPaneURL.Type 1: optional
Type 2 Music: optional
Type 2 Commerce: optional
ServiceInfo Represents the main element for the ServiceInfo.xml document.Type 1: required
Type 2 Music: required
Type 2 Commerce: required
ServiceTask1 Represents the first online store task pane.Type 1: required
Type 2 Music: required
Type 2 Commerce: required
ServiceTask2 Represents the second online store task pane.Type 1: ignored
Type 2 Music: optional
Type 2 Commerce: optional
ServiceTask3 Represents the third online store task pane.Type 1: ignored
Type 2 Music: optional
Type 2 Commerce: optional

Example ServiceInfo Document for a Type 1 Online Store

Example ServiceInfo Document for a Type 2 Online Store

Information Common to Type 1 and Type 2 Online Stores