Media-Objekt

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Das Media-Objekt bietet eine Möglichkeit zum Angeben oder Abrufen von Eigenschaften eines Medienelements mithilfe der folgenden Eigenschaften und Methoden.

Das Media-Objekt unterstützt die folgenden Eigenschaften.

Eigenschaft	Beschreibung
attributeCount	Ruft die Anzahl der Attribute ab, die für das Medienelement abgefragt und/oder festgelegt werden können.
duration	Ruft die Dauer des aktuellen Medienelements in Sekunden ab.
durationString	Ruft einen String-Wert ab, der die Dauer des aktuellen Medienelements im HH:MM:SS-Format angibt.
error	Ruft ein ErrorItem-Objekt ab, wenn das Medienelement eine Fehlerbedingung aufweist.
imageSourceHeight	Ruft die Höhe des aktuellen Medienelements in Pixel ab.
imageSourceWidth	Ruft die Breite des aktuellen Medienelements in Pixel ab.
markerCount	Ruft die Anzahl der Marker im Medienelement ab.
name	Gibt den Namen des Medienelements an oder ruft diesen ab.
sourceURL	Ruft die URL des Medienelements ab.

 

Das Media-Objekt unterstützt die folgenden Methoden.

Methode	Beschreibung
getAttributeCountByType	Ruft die Anzahl der Attribute ab, die dem angegebenen Attributnamen und der angegebenen Sprache zugeordnet sind.
getAttributeName	Ruft den Namen des Attributs ab, das dem angegebenen Index entspricht.
getItemInfo	Ruft den Wert des angegebenen Attributs für das Medienelement ab.
getItemInfoByAtom	Ruft den Wert des Attributs mit der angegebenen Indexnummer ab.
getItemInfoByType	Ruft den Wert des Attributs ab, das dem angegebenen Attributnamen, der angegebenen Sprache und dem angegebenen Index entspricht.
getMarkerName	Ruft den Namen des Markers am angegebenen Index ab.
getMarkerTime	Ruft die Zeit des Markers am angegebenen Index ab.
isIdentical	Ruft einen Wert ab, der angibt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.
isMemberOf	Ruft einen Wert ab, der angibt, ob das angegebene Medienelement ein Mitglied der angegebenen Wiedergabeliste ist.
isReadOnlyItem	Ruft einen Wert ab, der angibt, ob die Attribute des angegebenen Medienelements bearbeitet werden können.
setItemInfo	Legt den Wert des angegebenen Attributs für das Medienelement fest.

 

Der Zugriff auf das Media-Objekt erfolgt über die folgenden Eigenschaften und Methoden.

Object	Eigenschaft oder Methode
Steuerelemente	Currentitem
Player	currentMedia, newMedia
Wiedergabeliste	item

 

Denn es ist das häufigste Mittel des Zugriffs, Spieler. currentMedia wird zur Veranschaulichung in den Abschnitten der Referenzsyntax verwendet.

Siehe auch

Objektmodellreferenz für Skripterstellung