Media 对象

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

Media 对象提供了一种使用以下属性和方法指定或检索媒体项的属性的方法。

Media 对象支持以下属性。

属性	说明
attributeCount	检索可为媒体项查询和/或设置的属性数。
duration	检索当前媒体项的持续时间（以秒为单位）。
durationString	检索一个 String 值，该值指示当前媒体项的持续时间（HH：MM：SS 格式）。
error	如果媒体项具有错误条件，则检索 ErrorItem 对象。
imageSourceHeight	检索当前媒体项的高度（以像素为单位）。
imageSourceWidth	检索当前媒体项的宽度（以像素为单位）。
markerCount	检索媒体项中的标记数。
name	指定或检索媒体项的名称。
sourceURL	检索媒体项的 URL。

 

Media 对象支持以下方法。

方法	说明
getAttributeCountByType	检索与指定属性名称和语言关联的属性数。
getAttributeName	检索与指定索引对应的属性的名称。
getItemInfo	检索媒体项的指定属性的值。
getItemInfoByAtom	检索具有指定索引号的属性的值。
getItemInfoByType	检索对应于指定属性名称、语言和索引的属性的值。
getMarkerName	检索指定索引处的标记的名称。
getMarkerTime	检索标记在指定索引处的时间。
isIdentical	检索一个值，该值指示提供的对象是否与当前对象相同。
isMemberOf	检索一个值，该值指示指定的媒体项是否是指定播放列表的成员。
isReadOnlyItem	检索一个值，该值指示是否可以编辑指定媒体项的属性。
setItemInfo	设置媒体项的指定属性的值。

 

可通过以下属性和方法访问 Media 对象。

对象	属性或方法
控件	currentItem
播放器	currentMedia、 newMedia
播放列表	item

 

因为它是最常见的访问方式， 玩家。currentMedia 用于在参考语法部分进行说明。

另请参阅

用于脚本的对象模型参考