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物件是透過下列屬性和方法存取。

Object	屬性或方法
控制項	currentItem
球員	currentMedia、 newMedia
播放清單	item

 

因為這是最常見的存取方式， 所以玩家。currentMedia 用於參考語法區段中的圖例用途。

另請參閱

腳本的物件模型參考