External.changeView 方法

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

注意

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

changeView 方法更改Windows 媒体播放器中的视图。

语法

External.changeView(
  LibraryLocationType,
  LibraryLocationID,
  Filter,
  ViewParams
)

parameters

LibraryLocationType [in]

指定新视图类型的 库位置常量 。 例如，常量 CPGenreID 指定新视图将显示特定流派。

LibraryLocationID [in]

包含 要在新视图中显示的特定项的 ID 的字符串。 例如，如果 LibraryLocationType 为 CPGenreID，则此参数指定要在新视图中显示的流派的 ID。 此字符串可以为空。 请参阅“备注”。

筛选 [in]

包含新视图的筛选器的字符串。 将筛选视图，就像用户在玩家的字轮控件中输入了此文本一样。 此字符串可以为空。

ViewParams [in]

包含Windows 媒体播放器可用于新视图显示的新发现页的参数的字符串。 Windows 媒体播放器不解释这些参数。 它们由在线商店创建，仅对在线商店有意义。

返回值

此方法不返回值。

备注

在某些情况下，最好将 LibraryLocationID 参数设置为空字符串。 例如，如果将 LibraryLocationType 参数设置为 AllCPAlbumIDs，则新视图将表示所有相册。 新视图的重点不是单个相册，因此无需在 LibraryLocationID 参数中提供相册 ID。

ViewParams 参数为发现页面提供了一种与另一个发现页面通信的方式。 当发现页上的脚本调用 changeView 时，Windows 媒体播放器调整其用户界面。 该调整导致播放器调用插件的 IWMPContentPartner：：GetTemplate 方法以获取新发现页面的 URL。 原始发现页面在 ViewParams 参数中传递的字符串不会传递到 GetTemplate。 但是，新的发现页面可以通过调用 External.viewParameters 来检索 ViewParams 字符串。

要求

要求	值
版本	Windows 媒体播放器 11.
DLL	Wmp.dll

另请参阅

类型 1 在线商店的外部对象

External.changeViewOnlineList

External.libraryLocationID

External.libraryLocationType

External.viewParameters