ServiceTask1 Element
[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.
The ServiceTask1 element represents the first online store task pane.
<ServiceTask1
URL = "URL"
/>
Attributes
| Term | Description |
|---|---|
| URL (required) |
URL for the webpage that Windows Media Player displays. |
Parent/Child Elements
| Hierarchy | Element |
|---|---|
| Parent elements | ServiceInfo |
| Child elements | ButtonText, ButtonTip |
Remarks
ServiceTask1 is considered the primary task pane for engaging in commercial activity. It is the task pane that displays when the user chooses to purchase music.
Note
Windows Media Player 10 has three task panes where an online store can display its webpages. The online store can choose to use one, two, or all three of the task panes. Windows Media Player 11 has only one task pane, represented by ServiceTask1, which the user can view by clicking on the Online Stores tab.
Online store task panes share a single browser instance. This means that you should not write script code in your webpage that you expect to continue to run when the user switches away from the current service task.
When the user switches task panes, Windows Media Player stores the URL and session cookies. When the user switches back to the task pane, the Player restores the URL and cookies. If the user chooses to use a different online store, the URL and session data are cleared.
The following table details the parameters sent with the URL request. Others may be present for legacy compatibility purposes.
| Name | Value |
|---|---|
| geoid | Windows geographical location ID. The location ID is specified by the user in the Location area of the Regional and Language Options settings in Control Panel. |
| locale | Windows Media Player locale ID. |
| userlocale | Windows locale ID. The locale is specified by the user in the Standards and Formats area of the Regional and Language Options settings in Control Panel. |
| version | Windows Media Player version number using the following format: 10.0.x.xxxx or 11.0.x.xxxx. |
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player 10 or later. |