Player 对象
Player 对象是Windows 媒体播放器控件的根对象。 它支持下表中列出的属性、方法和事件。
Player 对象支持以下属性。 用星号标记的属性 (*) 无法访问皮肤。
| 属性 | 描述 |
|---|---|
| cdromCollection | 检索 CdromCollection 对象。 |
| closedCaption | 检索 ClosedCaption 对象。 |
| 控制 | 检索 Controls 对象。 |
| currentMedia | 指定或检索当前 Media 对象。 |
| currentPlaylist | 指定或检索当前 播放列表 对象。 |
| Dvd | 检索 DVD 对象。 |
| enableContextMenu * | 指定或检索一个值，该值指示是否启用上下文菜单，在单击鼠标右键时显示。 |
| 启用 * | 指定或检索一个值，该值指示是否启用Windows 媒体播放器控件。 |
| error | 检索 Error 对象。 |
| 全屏 * | 指定或检索一个值，该值指示是否以全屏模式播放视频内容。 |
| isOnline | 检索一个值，该值指示用户是否连接到网络。 |
| isRemote * | 检索一个值，该值指示Windows 媒体播放器控件是否在远程模式下运行。 |
| mediaCollection | 检索 MediaCollection 对象。 |
| network | 检索 Network 对象。 |
| openState | 检索一个值，该值指示内容源的状态。 |
| playerApplication * | 在远程Windows 媒体播放器控件运行时检索 PlayerApplication 对象。 |
| playlistCollection | 检索 PlaylistCollection 对象。 |
| playState | 检索一个值，该值指示Windows 媒体播放器操作的状态。 |
| 设置 | 检索设置对象。 |
| status | 检索一个值，该值指示Windows 媒体播放器的当前状态。 |
| stretchToFit * | 指定或检索一个值，该值指示视频是否拉伸以适应Windows 媒体播放器控件视频显示的大小。 |
| uiMode * | 指定或检索一个值，该值指示在网页中嵌入Windows 媒体播放器时用户界面中显示的控件。 |
| URL | 指定或检索要播放的剪辑的名称。 |
| versionInfo | 检索指定Windows 媒体播放器版本的字符串值。 |
| windowlessVideo * | 指定或检索一个值，该值指示Windows 媒体播放器控件是否以无窗口模式呈现视频。 |
* 皮肤无法访问。
Player 对象支持以下方法。
| 方法 | 说明 |
|---|---|
| close | 发布Windows 媒体播放器资源。 |
| launchURL | 将 URL 发送到要呈现的用户的默认浏览器。 |
| newMedia | 创建新的 Media 对象。 |
| newPlaylist | 创建新的 播放列表 对象。 |
| 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 | 当状态属性更改值时发生。 |
| StringCollectionChange | 字符串集合更改时发生。 |
| 警告 | 保留供将来使用。 |
* 皮肤无法访问。 有关在外观中处理鼠标和键盘事件的信息，请参阅 环境事件处理程序。
嵌入网页时，可以使用 OBJECT 标记中指定的 ID 值访问 Player 对象。 在外观定义文件中，使用 玩家 全局属性访问它。 出于说明目的， 播放器 将用作引用语法部分中的对象 ID。
另请参阅