详细的对象模型比较

  • 项目

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

下表将 Windows 媒体播放器 6.4 对象模型属性与Windows 媒体播放器 7 或更高版本的对象模型进行比较。

Windows 媒体播放器 6.4 属性 Windows 媒体播放器 7 或更高版本等效项
Player6。AllowChangeDisplaySize Windows 媒体播放器 7 或更高版本的显示会自动调整大小以适应媒体。 可以在 OBJECT> 标记或脚本中<设置高度和宽度属性。
Player6。AllowScan 控件。 fastForward 和 Controls。fastReverse 会自动为支持这些方法的文件类型启用。
Player6。AnglesAvailable 不可用。
Player6。AnimationAtStart 不可用。
Player6。AudioStream 使用 控件。currentAudioLanguageIndex。
Player6。AudioStreamsAvailable 使用 控件。audioLanguageCount。
Player6。AutoRewind 使用 控件。用于指定或检索当前位置的脚本中的 currentPosition 。 或者，使用标记和 Player。markerHit 事件。
Player6。AutoSize 自动调整大小是默认行为。 若要替代自动调整大小，请在 OBJECT> 标记或脚本中<设置高度和宽度属性。
Player6。自动启动 使用“设置”。autoStart。
Player6。平衡 使用“设置”。余额。
Player6。带宽 使用 网络。bandWidth。
Player6。BaseURL 使用“设置”。baseURL。
Player6。BufferingCount 使用 网络。bufferingCount。
Player6。BufferingProgress 使用 网络。bufferingProgress。
Player6。BufferingTime 使用 网络。bufferingTime。
Player6。ButtonsAvailable 不可用。
Player6。CanPreview 不可用。
Player6。CanScan 使用 控件。isAvailable (“FastForward”) 和 控件。isAvailable (“FastReverse”) 。
Player6。CanSeek 使用 控件。isAvailable 用于测试是否可以执行特定的查找方法。
Player6。CanSeekToMarkers 使用 控件。isAvailable (“CurrentMarker”) 。 使用 媒体。markerCount ，用于检索特定媒体项中的标记计数。 使用 控件。currentMarker 用于指定或检索当前标记编号。
Player6。CaptioningID 使用 ClosedCaption。captioningID。
Player6。CCActive 不可用。 有关隐藏式字幕在 Windows 媒体播放器 中如何更改的信息，请参阅隐藏式字幕。
Player6。ChannelDescription 不可用。
Player6。ChannelName 不可用。
Player6。ChannelURL 不可用。
Player6。ClickToPlay 不可用。 应在用户界面中提供控件以开始播放。 或者，用户可以右键单击视频图像以打开一个弹出菜单，其中包含 播放/暂停 选项（如果 Player）。enableContextMenu 等于 true。
Player6。ClientID 不可用。Windows 媒体播放器 9 系列或更高版本允许用户选择是否将唯一的玩家 ID 传输到内容提供商。
如果用户选择此选项，播放器将向 Windows Media 服务器发送唯一 ID。 该 ID 记录在服务器的日志文件中，该文件位于 中。默认情况下，system32\logfiles 文件夹。 日志字段名称为“c-playerid”。 默认情况下，Windows 媒体服务中不启用服务器日志记录。
如果用户未选择此选项，服务器将生成一个随机会话 ID，该 ID 对于给定会话的每个客户端都是唯一的。
有关详细信息，请参阅 Windows 媒体服务 9 系列文档。
Player6。CodecCount 不可用。
Player6。ColorKey 不可用。
Player6。ConnectionSpeed 不可用。 使用 网络。bitRate 用于确定当前比特率。
Player6。ContactAddress 不可用。
Player6。ContactEmail 不可用。
Player6。ContactPhone 不可用。
Player6。CreationDate 使用 MediaCollection。getMediaAtom (“CreationDate”) 检索创建日期原子的索引。 使用 媒体。getItemInfoByAtom 用于检索元数据。
Player6。CurrentAngle 不可用。
Player6。CurrentAudioStream 使用 控件。currentAudioLanguageIndex。
Player6。CurrentButton 不可用。
Player6。CurrentCCService 不可用。
Player6。CurrentChapter 检索当前播放列表。 如果当前播放列表与 Cdrom 返回的播放列表不同。播放列表，则没有当前章节。 否则，当前章节号是当前播放列表中当前媒体的索引。
Player6。CurrentDiscSide 不可用。
Player6。CurrentDomain 使用 DVD。域。
Player6。CurrentMarker 使用 控件。currentMarker。
Player6。CurrentPosition 使用 控件。currentPosition。
Player6。CurrentSubpictureStream 不可用。
Player6。CurrentTime 使用 控件。currentPositionTimeCode， 控件。currentPositionString 或 控件。currentPosition。
Player6。CurrentTitle 检索当前播放列表。 如果当前播放列表与 Cdrom 返回的播放列表相同。播放列表，则标题号是当前播放列表中当前媒体的索引。
Player6。CurrentVolume 不可用。
Player6。CursorType 不可用。 请改用 Internet Explorer 样式。
Player6。DefaultFrame 使用“设置”。defaultFrame，或在 OBJECT> 元素中使用 <<PARAM> 属性：
<PARAM NAME="defaultFrame" VALUE="right">
Player6。DisplayBackColor 不可用。
Player6。DisplayForeColor 不可用。
Player6。DisplayMode 可以使用 Controls 以数字的形式从头开始检索当前位置（ 以秒为单位）。currentPosition，格式为 HH：MM：SS 的字符串， (小时、分钟、秒) 使用控件。currentPositionString，或使用控件的时间代码格式。currentPositionTimeCode。
Player6。DisplaySize 默认显示会自动调整大小以适应媒体。 可以在 OBJECT> 标记或脚本中<设置高度和宽度属性。 使用 Player。fullScreen 切换到全屏模式。
Player6。时间 使用 媒体。持续时间。
Player6。Dvd 使用 Player。DVD。
Player6。EnableContextMenu 使用 Player。enableContextMenu。
Player6。启用 使用 Player。enabled。
Player6。EnableFullScreenControls 使用 Windows 媒体播放器 9 系列或更高版本时，除非 Player，否则会自动启用全屏控件。uiMode = “none”。
Player6。EnablePositionControls 不可用。 可以提供自定义控件或使用 Player。uimode 用于选择默认配置。
Player6。EnableTracker 不可用。 可以提供自定义控件或使用 Player。uimode 用于选择默认配置。
Player6。EntryCount 使用 播放列表。计数
Player6。ErrorCode 使用 ErrorItem。errorCode。
Player6。ErrorCorrection 不可用。
Player6。ErrorDescription 使用 ErrorItem。errorDescription。
Player6。文件名 使用 Player。URL 或 Player。currentMedia。 使用 控件。在播放列表中工作时的 currentItem 。
Player6。FramesPerSecond 不可用。
Player6。HasError 使用 Error。errorCount。
Player6。HasMultipleItems 不可用。
Player6。ImageSourceHeight 使用 媒体。imageSourceHeight。
Player6。ImageSourceWidth 使用 媒体。imageSourceWidth。
Player6。InvokeURLs 使用“设置”。invokeURLs。
Player6。IsBroadcast 使用 网络。sourceProtocol。
Player6。IsDurationValid 不可用。 媒体。与 当前媒体对象一起使用时，duration 包含有效值。
Player6。语言 使用 控件。currentAudioLanguage
Player6。LostPackets 使用 网络。lostPackets。
Player6。MarkerCount 使用 媒体。markerCount。
Player6。静音 使用“设置”。静音。
Player6。OpenState 使用 播放器。openState。
Player6。PlayCount 使用“设置”。playCount。
Player6。PlayState 使用 播放器。playState。
Player6。PreviewMode 不可用。 将脚本循环结构与 HTML 计时器配合使用来复制此功能。
Player6。率 使用“设置”。rate。
Player6。ReadyState 使用 播放器。openState。
Player6。ReceivedPackets 使用 网络。receivedPackets。
Player6。ReceptionQuality 使用 网络。receptionQuality。
Player6。RecoveredPackets 使用 网络。recoveredPackets。
Player6。根 不可用。
Player6。SAMIFileName 使用 ClosedCaption。SAMIFileName。
Player6。SAMILang 使用 ClosedCaption。SAMILang。
Player6。SAMIStyle 使用 ClosedCaption。SAMIStyle。
Player6。SelectionEnd 使用 媒体。用于 确定 Media 对象的长度的持续时间。 将标记与 控件配合使用。用于指定自定义结束位置的 currentMarker 。
Player6。SelectionStart 使用 控件。currentPosition 用于从特定位置开始播放或对 控件使用标记。用于指定自定义起始位置的 currentMarker 。
Player6。SendErrorEvents 错误已排队。 使用 Error 对象和 ErrorItem 对象检索错误信息。
Player6。SendKeyboardEvents 不可用。
Player6。SendMouseClickEvents 不可用。
Player6。SendMouseMoveEvents 不可用。
Player6。SendOpenStateChangeEvents 不可用。
Player6。SendPlayStateChangeEvents 不可用。
Player6。SendWarningEvents 不可用。
Player6。ShowAudioControls 不可用。 可以提供自定义控件或使用 Player。uimode 用于选择默认配置。
Player6。ShowCaptioning 不可用。 可以提供自定义关闭描述文字显示。
Player6。ShowControls 不可用。 可以提供自定义控件或使用 Player。uimode 用于选择默认配置。
Player6。ShowDisplay 不可用。
Player6。ShowGotoBar 不可用。 可以使用 Media 对象提供自定义功能
Player6。ShowPositionControls 不可用。 可以提供自定义控件或使用 Player。uimode 用于选择默认配置。
Player6。ShowStatusBar 不可用。 可以提供自定义控件或使用 Player。uimode 用于选择默认配置。
Player6。ShowTracker 不可用。 可以提供自定义控件或使用 Player。uimode 用于选择默认配置。
Player6。SourceLink 使用 媒体。sourceURL。
Player6。SourceProtocol 使用 网络。sourceProtocol。
Player6。StreamCount 不可用。 使用 控件。audioLanguageCount ，用于检索音频语言流的数量。
Player6。SubpictureOn 不可用。
Player6。SubpictureStreamsAvailable 不可用
Player6。TitlesAvailable 使用以下命令：Player.Cdrom.playlist.count - 1
Player6。TotalTitleTime 使用 currentMedia。duration 或 currentMedia。durationString。
Player6。TransparentAtStart 使用脚本指定高度和宽度值，使玩家可见或不可见。
Player6。UniqueID 不可用。
Player6。VideoBorder3D 不可用。
Player6。VideoBorderColor 不可用。
Player6。VideoBorderWidth 不可用。
Player6。体积 使用“设置”。卷。
Player6。VolumesAvailable 不可用。

下表将Windows 媒体播放器版本 6.4 对象模型方法与Windows 媒体播放器 7 或更高版本的对象模型进行比较。

Windows 媒体播放器 6.4 方法 Windows 媒体播放器 7 或更高版本等效项
Player6。AboutBox 使用 Player。versionInfo 用于检索Windows 媒体播放器的版本。
Player6。BackwardScan 使用“设置”。rate。
Player6。ButtonActivate 不可用。
Player6。ButtonSelectAndActivate 不可用。
Player6。取消 不可用。
Player6。ChapterPlay 如果已播放指定的游戏播放列表，请使用以下语法将所需章节检索为媒体对象：
var media = Player.currentPlaylist.item(index);
然后，指定 Player。currentMedia 使用返回的媒体对象。
Player6。ChapterPlayAutoStop 不可用。
Player6。ChapterSearch 如果已播放指定的游戏播放列表，请使用以下语法将所需章节检索为媒体对象：
var media = Player.currentPlaylist.item(index);
然后，指定 Player。currentMedia 使用返回的媒体对象。
Player6。FastForward 使用 控件。fastForward。
Player6。FastReverse 使用 控件。fastReverse。
Player6。ForwardScan 使用“设置”。rate。
Player6。GetAllGPRMs 不可用。
Player6。GetAllSPRMs 不可用。
Player6。GetAudioLanguage 使用 控件。currentAudioLanguage 用于检索当前音频语言的 LCID。
Player6。GetCodecDescription 不可用。
Player6。GetCodecInstalled 不可用。
Player6。GetCodecURL 使用 ErrorItem。customUrl。
Player6。GetCurrentEntry 使用脚本循环访问当前播放列表。 使用 媒体。isIdentical 用于将播放列表中的每个条目与 Player 进行比较。currentMedia 对象。
Player6。GetMarkerName 使用 媒体。getMarkerName。
Player6。GetMarkerTime 使用 媒体。getMarkerTime。
Player6。GetMediaInfoString 使用 媒体。getItemInfo、 Media。getItemInfoByAtom 及其用于检索元数据的关联方法。
Player6。GetMediaParameter 使用 播放列表。用于 检索媒体项的项。 然后使用 媒体。getItemInfo 用于检索参数字符串。
Player6。GetMediaParameterName 使用 播放列表。用于 检索媒体项的项。 然后使用 媒体。getAttributeName 用于检索参数字符串。
Player6。GetMoreInfoURL 不可用。
Player6。GetNumberOfChapters 如果游戏当前正在播放，请使用 currentPlaylist。count。
Player6。GetStreamGroup 不可用。
Player6。GetStreamName 不可用。
Player6。GetStreamSelected 不可用。
Player6。GetSubpictureLanguage 不可用。
Player6。GoUp 使用 DVD。返回。
Player6。IsSoundCardEnabled 不可用。
Player6。LeftButtonSelect 不可用。
Player6。LowerButtonSelect 不可用。
Player6。MenuCall 使用 DVD。titleMenu 或 DVD。topMenu。
Player6。下 使用 控件。next.
Player6。NextPGSearch 使用 控件。next.
Player6。打开 使用 Player。URL 或 Player。currentMedia。 文件始终以异步方式打开。
Player6。暂停 使用 控件。暂停。
Player6。玩 使用 控件。播放。
Player6。以前 使用 控件。previous.
Player6。PrevPGSearch 使用 控件。previous.
Player6。ResumeFromMenu 使用 DVD。resume。
Player6。RightButtonSelect 不可用。
Player6。SetCurrentEntry 使用 currentPlaylist 检索媒体对象。item (entryNumber) 。 然后，使用 Controls 指定检索的媒体对象。currentItem。
Player6。ShowDialog 不可用。
Player6。StillOff 使用 控件。播放。 或者，使用 控件。下一步 （如果当前处于静止模式）。
Player6。停止 使用 控件。停止。
Player6。StreamSelect 不可用。 使用 控件。currentAudioLanguage 用于指定音频语言流。
Player6。TimePlay 在根播放列表中，使用 currentPlaylist。item (索引) 检索媒体对象。 然后，使用 Controls 将媒体对象设置为当前 对象。currentItem。 然后，指定 Controls。使用时间值（以秒为单位）的 currentPosition 。
Player6。TimeSearch 使用 控件。currentPosition。
Player6。TitlePlay 如果已播放指定的游戏播放列表，请使用以下语法将所需章节检索为媒体对象：
var media = Player.currentPlaylist.item(index);
然后，指定 Player。currentMedia 使用返回的媒体对象。
或者，使用 currentPlaylist。项 以检索媒体对象，然后使用返回的媒体对象指定 Controls。currentItem。
Player6。TopPGSearch 不可用。
Player6。UOPValid 不可用
Player6。UpperButtonSelect 不可用。

下表将Windows 媒体播放器版本 6.4 对象模型事件与Windows 媒体播放器 7 或更高版本的对象模型进行比较。

Windows 媒体播放器 6.4 事件 Windows 媒体播放器 7 或更高版本等效项
Player6。缓冲 使用 Player。缓冲。
Player6。点击 使用 Player。点击
Player6。DblClick 使用 Player。双击
Player6。断开 不可用。
Player6。DisplayModeChange 不可用。
Player6。DVDNotify 玩家。DomainChange 和 Player。OpenPlaylistSwitch 是 DVD 特定的事件。 与播放列表、媒体和 CD-ROM 媒体相关的其他事件也可能适用，具体取决于应用程序。
Player6。EndOfStream 使用 Player。PlayState。
Player6。错误 事件保持不变。 但是，错误会排队。 使用 Error 对象和 ErrorItem 对象从队列中检索错误信息。 请参阅上一节错误处理中的示例代码。
Player6。KeyDown 使用 Player。Keydown
Player6。KeyPress 使用 Player。KeyPress
Player6。KeyUp 使用 Player。KeyUp
Player6。MarkerHit 使用 Player。MarkerHit。
Player6。MouseDown 使用 Player。MouseDown
Player6。MouseMove 使用 Player。MouseMove
Player6。MouseUp 使用 Player。MouseUp
Player6。NewStream 使用 Player。OpenStateChange
Player6。OpenStateChange 使用 Player。OpenStateChange。
Player6。PlayStateChange 使用 Player。PlayStateChange。
Player6。PositionChange 使用 Player。PositionChange。
Player6。ReadyStateChange 使用 Player。PlayStateChange。
Player6。ScriptCommand 使用 Player。ScriptCommand。
Player6。警告 不可用。

对象模型迁移指南

脚本的对象模型参考