库集成

  • 项目

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

Windows 媒体播放器用户界面组织到功能区域（称为任务窗格）中，这些区域封装了程序的各种高级功能。 其中包括 库、 同步和 刻录 任务窗格等 () 。 “ 库 ”任务窗格使用户能够使用库;“ 同步 ”任务窗格使用户能够将数字媒体文件同步到便携式设备;“ 刻录 ”任务窗格使用户能够将数字媒体文件刻录到 CD 或 DVD。

注意

“库”任务窗格有时称为“浏览”任务窗格。

 

其中每个任务窗格都具有与库的某种程度的集成。 例如，如果用户想要将音乐刻录到 CD，则让用户通过浏览库并将媒体项拖放到列表中来选择要刻录的音乐是有意义的。 这意味着，在“ 库”、“ 同步”和“ 刻录 ”任务窗格中工作时，用户可以查看和使用完全集成到库中的在线商店目录。 WMPTaskType 枚举包含表示这三个任务窗格的值，以便以编程方式标识它们。

这三个任务窗格中的每一个都组织成三个主要部分。 第一部分是库树视图控件。 此控件为用户提供Windows 媒体播放器库的分层视图，包括按歌曲、艺术家、专辑等分类功能。 第二个任务窗格部分是详细信息窗格。 此窗格提供根据当前在库树视图控件中选择的类别组织的详细信息。 例如，如果用户在树视图中单击了 “歌曲 ”，则详细信息窗格将显示库中当前存在的歌曲标题以及其他信息，如长度和专辑标题。 第三部分是列表窗格或 购物篮。 用户可以将媒体项拖放到购物篮上以构建列表，例如播放列表、同步列表和刻录列表。

当在线商店目录与库集成时，在线商店在库树视图控件中显示为顶级类别或 节点。 (一次只有一个在线商店目录对用户可见。) 当用户选择通过单击节点查看在线商店目录时，详细信息窗格会显示有关在线商店目录中的音乐的信息。 这包括用户已购买或租用的音乐，以及用户尚未获取的音乐。

顶级在线商店节点具有Windows 媒体播放器提供的一组子节点。 例如，顶级在线商店节点具有 Radio、Artist 和 Album 子节点等。 顶级在线商店节点还可以具有在线商店提供的最多 8 个自定义子节点。 Windows 媒体播放器为列表标识符在 0 到 7 范围内的任何列表创建自定义子节点。 在线商店指定 list.csv 文件中属于应用商店目录的列表的标识符。

Windows 媒体播放器通过调用 IWMPContentPartner：：GetItemInfo 并在 bstrInfoName 参数中传递 CPListIDIcon 来检索在线商店的每个自定义树节点的图标。

当用户在目录中导航时，Windows 媒体播放器调用 IWMPContentPartner：：GetItemInfo，以从内容合作伙伴插件中检索有关用户选择的音乐项的元数据。 此元数据向 Player 提供信息，以便玩家可以显示有关目录项的详细信息。 例如，如果用户选择专辑，Windows 媒体播放器检索专辑封面 URL，以便用户可以看到专辑封面。

关于类型 1 在线商店