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

  • 项目

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

注意

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

 

External 对象为网页提供功能，这些网页由在线商店提供，托管在 Windows 媒体播放器 中。

External 对象公开类型 1 在线商店的以下属性。

属性 说明
accountType 检索当前用户的帐户类型。
appColorButtonHighlight 检索Windows 媒体播放器用户界面的当前按钮突出显示颜色。
appColorButtonHoverFace 检索Windows 媒体播放器用户界面的当前按钮悬停颜色。
appColorButtonShadow 检索Windows 媒体播放器用户界面的当前按钮阴影颜色。
appColorDark 检索Windows 媒体播放器用户界面的当前深色底纹颜色。
appColorLight 检索Windows 媒体播放器用户界面的当前浅色底色。
appColorMedium 检索Windows 媒体播放器用户界面的当前中等着色颜色。
basketTitle 检索列表窗格中按钮的标题， (Windows 媒体播放器中也称为购物篮) 。
filter 检索Windows 媒体播放器当前正在使用的搜索筛选器。
ignoreIEHistory 指定Windows 媒体播放器是否应忽略 Internet Explorer 历史记录。
libraryLocationID 检索当前显示在 Player 视图中的特定媒体项的标识符。
libraryLocationType 检索一个库位置常量，该常量指示Windows 媒体播放器中当前视图的类型。
pluginRunning 检索一个值，该值指示在线商店的插件是否正在运行。
selectedItemID 检索当前在Windows 媒体播放器中选择的媒体项的标识符。
selectedItemType 检索当前在Windows 媒体播放器中选择的媒体项的类型。
任务 检索当前任务窗格的名称。
templateBeingDisplayedInLocalLibrary 指示当前发现页表示的源是否正在本地库树视图控件中显示。
userLoggedIn 检索一个值，该值指示用户是否已登录到在线商店。
version 检索Windows 媒体播放器的当前版本。
viewParameters 检索与Windows 媒体播放器中的当前视图关联的参数。

 

External 对象公开类型 1 在线商店的以下方法。

方法 说明
addToBasket 将媒体项添加到列表窗格 (也称为Windows 媒体播放器中的购物篮) 。
attemptLogin 显示一个对话框，以便用户可以尝试登录到在线商店。
身份 验证 启动对用户进行身份验证的尝试。
buy 启动一组媒体项的购买。
cancelNavigate 通知Windows 媒体播放器，即使播放器中的视图已更改，也不应显示新的发现页面。
changeView 更改Windows 媒体播放器中的视图。
changeViewOnlineList 更改 Windows 媒体播放器 中的视图以显示由在线商店动态生成的列表。
下载 启动一组媒体项的下载。
玩游戏 指示Windows 媒体播放器播放一组媒体项。
saveCurrentViewToLibrary 从当前视图中的媒体项创建播放列表，并将播放列表保存到本地库。
sendMessage 向在线商店的插件发送消息。
showPopup 指示Windows 媒体播放器显示弹出网页;即显示在单独窗口中的网页。

 

External 对象公开类型 1 在线商店的以下事件。

事件 说明
OnChangeViewError 在调用 External.ChangeView 方法导致错误时发生。
OnChangeViewOnlineListError 在调用 External.ChangeViewOnlineList 方法导致错误时发生。
OnColorChange 当Windows 媒体播放器用户界面的颜色更改时发生。
OnLoginChange 当用户的登录状态更改或尝试登录失败时发生。
OnSendMessageComplete 当在线商店处理完消息时发生。
OnViewChange 当视图在 Windows 媒体播放器 中更改时发生。

 

类型 1 在线商店的参考

远程处理 Windows Media Player 控件