Player 对象

  • 项目

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

Player 对象是Windows 媒体播放器控件的根对象。 它支持下表中列出的属性、方法和事件。

Player 对象支持以下属性。 标有星号 (*) 的属性对皮肤不可访问。

属性 说明
cdromCollection 检索 CdromCollection 对象。
closedCaption 检索 ClosedCaption 对象。
控制 检索 Controls 对象。
currentMedia 指定或检索当前 Media 对象。
currentPlaylist 指定或检索当前 Playlist 对象。
Dvd 检索 DVD 对象。
enableContextMenu * 指定或检索一个值，该值指示是否启用上下文菜单，该菜单在单击鼠标右键时显示。
启用 * 指定或检索一个值，该值指示是否启用Windows 媒体播放器控件。
error 检索 Error 对象。
全屏 * 指定或检索一个值，该值指示是否以全屏模式播放视频内容。
isOnline 检索一个值，该值指示用户是否已连接到网络。
isRemote * 检索一个值，该值指示Windows 媒体播放器控件是否在远程模式下运行。
mediaCollection 检索 MediaCollection 对象。
network 检索 Network 对象。
openState 检索指示内容源状态的值。
playerApplication * 在远程Windows 媒体播放器控件运行时检索 PlayerApplication 对象。
playlistCollection 检索 PlaylistCollection 对象。
playState 检索指示Windows 媒体播放器操作状态的值。
设置 检索 Settings 对象。
status 检索一个值，该值指示Windows 媒体播放器的当前状态。
stretchToFit * 指定或检索一个值，该值指示视频是否拉伸以适应Windows 媒体播放器控制视频显示的大小。
uiMode * 指定或检索一个值，该值指示在网页中嵌入Windows 媒体播放器时用户界面中显示的控件。
URL 指定或检索要播放的剪辑的名称。
versionInfo 检索指定Windows 媒体播放器版本的 String 值。
windowlessVideo * 指定或检索一个值，该值指示Windows 媒体播放器控件是否以无窗口模式呈现视频。

 

* 皮肤无法访问。

Player 对象支持以下方法。

方法 说明
close 发布Windows 媒体播放器资源。
launchURL 将 URL 发送到要呈现的用户的默认浏览器。
newMedia 创建新的 Media 对象。
newPlaylist 创建新的 Playlist 对象。
openPlayer 使用指定的 URL 打开Windows 媒体播放器。

 

Player 对象支持以下事件。 标有星号 (*) 的事件对皮肤不可访问。 有关在皮肤中处理鼠标和键盘事件的信息，请参阅 外部事件。

事件 说明
AudioLanguageChange 在当前音频语言更改时发生。
缓冲 当Windows 媒体播放器控件开始或结束缓冲时发生。
CdromMediaChange 当 CD 或 DVD 插入或从 CD 或 DVD 驱动器中弹出时发生。
点击 * 当用户单击鼠标按钮时发生。
CurrentItemChange 在 控件时发生。currentItem 更改。
CurrentMediaItemAvailable 当当前媒体项中的图形元数据项变得可用时发生。
CurrentPlaylistChange 在当前播放列表中发生更改时发生。
CurrentPlaylistItemAvailable 当当前播放列表项可用时发生。
断开连接 保留供将来使用。
DomainChange 在 DVD 域更改时发生。
双击 * 当用户双击鼠标按钮时发生。
DurationUnitChange 保留供将来使用。
EndOfStream 保留供将来使用。
错误 当Windows 媒体播放器控件具有错误条件时发生。
KeyDown * 在按下某个键时发生。
KeyPress * 在按下然后释放某个键时发生。
KeyUp * 在松开某个键时发生。
MarkerHit 到达标记时发生。
MediaChange 在媒体项更改时发生。
MediaCollectionAttributeStringAdded 将属性值添加到库时发生。
MediaCollectionAttributeStringChanged 更改库中的属性值时发生。
MediaCollectionAttributeStringRemoved 从库中删除属性值时发生。
MediaCollectionChange 在媒体集合更改时发生。
MediaCollectionMediaAdded 将媒体项添加到本地库时发生。
MediaCollectionMediaRemoved 从本地库中删除媒体项时发生。
MediaError 当 Media 对象具有错误条件时发生。
ModeChange 更改Windows 媒体播放器模式时发生。
MouseDown * 按下鼠标按钮时发生。
MouseMove * 移动鼠标指针时发生。
MouseUp * 松开鼠标按钮时发生。
NewStream 保留供将来使用。
OpenPlaylistSwitch 当 DVD 上的游戏开始播放时发生。
OpenStateChange 当Windows 媒体播放器控件更改状态时发生。
PlaylistChange 在播放列表更改时发生。
PlaylistCollectionChange 在播放列表集合中发生更改时发生。
PlaylistCollectionPlaylistAdded 将播放列表添加到播放列表集合时发生。
PlaylistCollectionPlaylistRemoved 从播放列表集合中删除播放列表时发生。
PlaylistCollectionPlaylistSetAsDeleted 保留供将来使用。
PlayStateChange 在Windows 媒体播放器控件的播放状态更改时发生。
PositionChange 当媒体项的当前位置已更改时发生。
ScriptCommand 在收到同步的命令或 URL 时发生。
StatusChange 在 status 属性更改值时发生。
StringCollectionChange 在字符串集合更改时发生。
警告 保留供将来使用。

 

* 皮肤无法访问。 有关在皮肤中处理鼠标和键盘事件的信息，请参阅 环境事件处理程序。

嵌入网页时，可以使用 OBJECT 标记中指定的 ID 值访问 Player 对象。 在皮肤定义文件中，可以使用 player 全局属性对其进行访问。 出于说明目的， player 将用作参考语法部分中的对象 ID。

另请参阅

脚本的对象模型参考