ServiceTask1 元素

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意

本部分介绍专为在线商店使用而设计的功能。 不支持在在线商店上下文之外使用此功能。

ServiceTask1 元素表示第一个在线商店任务窗格。

<ServiceTask1
    URL = "URL"
/>

属性

术语	描述
需要 URL ()	Windows 媒体播放器显示的网页的 URL。

父/子元素

层次结构	元素
父元素	ServiceInfo
子元素	ButtonText、 ButtonTip

备注

ServiceTask1 被视为用于参与商业活动的主要任务窗格。 它是当用户选择购买音乐时显示的任务窗格。

注意

Windows 媒体播放器 10 有三个任务窗格，在线商店可在其中显示其网页。 在线商店可以选择使用一个、两个或全部三个任务窗格。 Windows 媒体播放器 11 只有一个任务窗格，由 ServiceTask1 表示，用户可以通过单击“在线商店”选项卡进行查看。

在线商店任务窗格共享单个浏览器实例。 这意味着，不应在网页中编写用户离开当前服务任务时预期会继续运行的脚本代码。

当用户切换任务窗格时，Windows 媒体播放器存储 URL 和会话 Cookie。 当用户切换回任务窗格时，Player 会还原 URL 和 Cookie。 如果用户选择使用不同的在线商店，则会清除 URL 和会话数据。

下表详细说明了随 URL 请求发送的参数。 其他可能出于旧兼容性目的而存在。

名称	值
大地 水准面	Windows 地理位置 ID。 位置 ID 由用户在 控制面板 中“区域和语言选项”设置的位置区域中指定。
locale	Windows 媒体播放器区域设置 ID。
userlocale	Windows 区域设置 ID。 区域设置由用户在 控制面板 中“区域和语言选项”设置的“标准和格式”区域中指定。
version	使用以下格式Windows 媒体播放器版本号：10.0.x.xxxx 或 11.0.x.xxxx。

要求

要求	值
版本	Windows 媒体播放器 10 或更高版本。

另请参阅

类型 1 在线商店的示例 ServiceInfo 文档

类型 2 在线商店的示例 ServiceInfo 文档

ServiceInfo 文档