Share via

Image 元素 (WMP SDK)

  • 项目

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

注意

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

Image 元素指定Windows 媒体播放器向用户显示以表示在线商店的图像。

<Image
    EulaURL = "URL"
    MenuURL = "URL"
    ServiceLargeURL = "URL"
    ServiceSmallURL = "URL"
/>

属性

类型 1 存储所需的 EulaURL (，对于类型 2) 忽略

Windows 媒体播放器在最终用户许可协议 (EULA) 对话框中显示的徽标的 URL。 这必须是 80 x 80 像素的 PNG 图像。

MenuURL (可选)

Windows 媒体播放器显示在服务菜单上的图像的 URL。 此图像必须为 15 x 15 像素。

ServiceLargeURL (可选)

对于类型 1 的在线商店，这是Windows 媒体播放器显示在“在线商店”选项卡上的图像的 URL。对于 11 Windows 媒体播放器，此图像必须为 45 像素宽 x 13 像素高。 对于Windows 媒体播放器 12，此图像必须为 45 像素宽 x 30 像素高。 若要同时支持 Windows 媒体播放器 版本 11 和 12，必须提供两个单独的ServiceInfo.xml文档，每个文档都指向 ServiceLargeURL 适当大小的映像。

对于类型 2 在线商店，这是Windows 媒体播放器显示在“在线商店”选项卡旁边或任务窗格按钮旁边的图像的 URL。 此图像必须为 30 x 30 像素。

ServiceSmallURL (可选)

与 Description 元素中指定的 市场营销说明一起显示的徽标的 URL。 如果未提供，它将为空。 (所有类型，可选) 此图像必须是 45 像素宽、13 像素高的 PNG 图像。

父/子元素

层次结构 元素
父元素 ServiceInfo
子元素 无

备注

支持的图像格式为.gif、.jpg、.bmp和.png (这是建议) 格式。 支持和推荐使用 Web 透明度。 不支持动态 GIF 文件。

如果未为 MenuURL 提供值，Windows 媒体播放器在在线商店的菜单上不显示图形。

可以为 ServiceLargeURL 提供动画图像。 在 Windows 媒体播放器 10 或 11 中，图像将进行动画处理。 在 Windows 媒体播放器 12 中，仅显示图像的第一帧。 若要提供动画图像，请创建包含动画连续帧的单个图像文件。 例如，对于宽 30 像素、高 30 像素的图像，可以在 600 像素宽、30 像素高的图像中并排提供 20 个连续图像。 Windows 媒体播放器将通过逐个显示 20 个图像自动对此类图像进行动画处理。 此动画仅在在线商店打开时发生一次;它不会重复。

要求

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

另请参阅

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

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

ServiceInfo 文档