ServiceTask3 元素
[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能,Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
注意
本部分介绍专为在线商店使用而设计的功能。 不支持在在线商店上下文之外使用此功能。
ServiceTask3 元素表示第三个在线商店任务窗格。
<ServiceTask3
URL = "URL"
/>
属性
术语 | 说明 |
---|---|
需要 URL () |
Windows 媒体播放器显示的网页的 URL。 |
父/子元素
层次结构 | 元素 |
---|---|
父元素 | ServiceInfo |
子元素 | ButtonText、 ButtonTip |
备注
ServiceTask1 被视为用于参与商业活动的主要任务窗格。 它是当用户选择购买音乐时显示的任务窗格。 将 ServiceTask3 用于其他在线商店活动。
注意
Windows 媒体播放器 10 有三个任务窗格,在线商店可在其中显示其网页。 在线商店可以选择使用一个、两个或全部三个任务窗格。 Windows 媒体播放器 11 只有一个任务窗格,用户可通过单击“在线商店”选项卡查看该窗格。Windows 媒体播放器 11 将忽略 ServiceTask2 和 ServiceTask3 元素。
在线商店任务窗格共享单个浏览器实例。 这意味着,不应在网页中编写用户离开当前服务任务时预期会继续运行的脚本代码。
当用户切换任务窗格时,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 或更高版本。 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈