Player-Objekt

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

Das Player-Objekt ist das Stammobjekt für das Windows Medienwiedergabe-Steuerelements. Es unterstützt die In den folgenden Tabellen aufgeführten Eigenschaften, Methoden und Ereignisse.

Das Player-Objekt unterstützt die folgenden Eigenschaften. Mit einem Sternchen (*) markierte Eigenschaften sind für Skins nicht zugänglich.

Eigenschaft	Beschreibung
cdromCollection	Ruft das CdromCollection-Objekt ab.
closedCaption	Ruft das ClosedCaption-Objekt ab .
Steuerelemente	Ruft das Controls-Objekt ab.
currentMedia	Gibt das aktuelle Media-Objekt an oder ruft es ab.
currentPlaylist	Gibt das aktuelle Wiedergabelistenobjekt an oder ruft es ab.
Dvd	Ruft das DVD-Objekt ab.
enableContextMenu *	Gibt einen Wert an, der angibt, ob das Kontextmenü aktiviert werden soll, das beim Klicken mit der rechten Maustaste angezeigt wird, oder ruft diesen ab.
Aktiviert *	Gibt einen Wert an, der angibt, ob das Windows Medienwiedergabe-Steuerelement aktiviert ist, oder ruft einen Wert ab.
error	Ruft das Error-Objekt ab.
Fullscreen *	Gibt einen Wert an, der angibt, ob Videoinhalte im Vollbildmodus wiedergegeben werden, oder ruft er ab.
isOnline	Ruft einen Wert ab, der angibt, ob der Benutzer mit einem Netzwerk verbunden ist.
isRemote *	Ruft einen Wert ab, der angibt, ob das Windows Medienwiedergabe-Steuerelements im Remotemodus ausgeführt wird.
mediaCollection	Ruft das MediaCollection-Objekt ab.
network	Ruft das Network-Objekt ab.
openState	Ruft einen Wert ab, der den Zustand der Inhaltsquelle angibt.
playerApplication *	Ruft das PlayerApplication-Objekt ab, wenn ein remoted Windows Medienwiedergabe-Steuerelement ausgeführt wird.
playlistCollection	Ruft das PlaylistCollection-Objekt ab.
playState	Ruft einen Wert ab, der den Zustand des Windows Medienwiedergabe Vorgangs angibt.
settings	Ruft das Settings-Objekt ab.
status	Ruft einen Wert ab, der die aktuelle status von Windows Medienwiedergabe angibt.
stretchToFit *	Gibt einen Wert an, der angibt, ob das Video an die Größe des Windows Medienwiedergabe-Steuerelementvideodisplays angepasst wird, oder ruft diesen ab.
uiMode *	Gibt einen Wert an, der angibt, welche Steuerelemente auf der Benutzeroberfläche angezeigt werden, wenn Windows Medienwiedergabe in eine Webseite eingebettet ist.
URL	Gibt den Namen des zu wiedergebenden Clips an oder ruft diesen ab.
versionInfo	Ruft einen String-Wert ab, der die Version des Windows Medienwiedergabe angibt.
windowlessVideo *	Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob das Windows Medienwiedergabe-Steuerelement Video im fensterlosen Modus rendert.

 

* Nicht zugänglich für Skins.

Das Player-Objekt unterstützt die folgenden Methoden.

Methode	Beschreibung
close	Gibt Windows Medienwiedergabe Ressourcen frei.
launchURL	Sendet eine URL an den Standardbrowser des Benutzers, der gerendert werden soll.
Newmedia	Erstellt ein neues Media-Objekt .
newPlaylist	Erstellt ein neues Wiedergabelistenobjekt .
openPlayer	Öffnet Windows Medienwiedergabe unter Verwendung der angegebenen URL.

 

Das Player-Objekt unterstützt die folgenden Ereignisse. Ereignisse, die mit einem Sternchen (*) gekennzeichnet sind, sind für Skins nicht zugänglich. Informationen zum Behandeln von Maus- und Tastaturereignissen in Skins finden Sie unter Externe Ereignisse.

Ereignis	Beschreibung
AudioLanguageChange	Tritt auf, wenn sich die aktuelle Audiosprache ändert.
Pufferung	Tritt auf, wenn das Windows Medienwiedergabe-Steuerelement das Puffern beginnt oder beendet.
CdromMediaChange	Tritt auf, wenn eine CD oder DVD in ein CD- oder DVD-Laufwerk ein- oder ausgeworfen wird.
Klicken *	Tritt auf, wenn der Benutzer auf eine Maustaste klickt.
CurrentItemChange	Tritt auf, wenn Steuerelemente.currentItem-Änderungen .
CurrentMediaItemAvailable	Tritt auf, wenn ein grafisches Metadatenelement im aktuellen Medienelement verfügbar wird.
CurrentPlaylistChange	Tritt auf, wenn sich etwas innerhalb der aktuellen Wiedergabeliste ändert.
CurrentPlaylistItemAvailable	Tritt auf, wenn das aktuelle Wiedergabelistenelement verfügbar wird.
Disconnect (Trennen)	Für die zukünftige Verwendung reserviert.
DomainChange	Tritt auf, wenn sich die DVD-Domäne ändert.
Doubleclick *	Tritt auf, wenn der Benutzer auf eine Maustaste doppelt klickt.
DurationUnitChange	Für die zukünftige Verwendung reserviert.
EndOfStream	Für die zukünftige Verwendung reserviert.
Fehler	Tritt auf, wenn das Windows Medienwiedergabe-Steuerelement eine Fehlerbedingung aufweist.
Keydown *	Tritt beim Drücken einer Taste ein.
Keypress *	Tritt auf, wenn eine Taste gedrückt und dann freigegeben wird.
Keyup *	Tritt ein, wenn eine Taste losgelassen wird.
MarkerHit	Tritt auf, wenn ein Marker erreicht wird.
MediaChange	Tritt auf, wenn sich ein Medienelement ändert.
MediaCollectionAttributeStringAdded	Tritt auf, wenn der Bibliothek ein Attributwert hinzugefügt wird.
MediaCollectionAttributeStringChanged	Tritt auf, wenn ein Attributwert in der Bibliothek geändert wird.
MediaCollectionAttributeStringRemoved	Tritt auf, wenn ein Attributwert aus der Bibliothek entfernt wird.
MediaCollectionChange	Tritt auf, wenn sich die Mediensammlung ändert.
MediaCollectionMediaAdded	Tritt auf, wenn der lokalen Bibliothek ein Medienelement hinzugefügt wird.
MediaCollectionMediaRemoved	Tritt auf, wenn ein Medienelement aus der lokalen Bibliothek entfernt wird.
MediaError	Tritt auf, wenn das Media-Objekt eine Fehlerbedingung aufweist.
ModeChange	Tritt auf, wenn ein Modus von Windows Medienwiedergabe geändert wird.
Mousedown *	Tritt auf, wenn eine Maustaste gedrückt wird.
Mousemove *	Tritt auf, wenn der Mauszeiger verschoben wird.
Mouseup *	Tritt auf, wenn eine Maustaste losgelassen wird.
NewStream	Für die zukünftige Verwendung reserviert.
OpenPlaylistSwitch	Tritt auf, wenn ein Titel auf einer DVD abgespielt wird.
OpenStateChange	Tritt auf, wenn das Windows Medienwiedergabe-Steuerelement den Zustand ändert.
PlaylistChange	Tritt auf, wenn sich eine Wiedergabeliste ändert.
PlaylistCollectionChange	Tritt auf, wenn sich etwas in der Wiedergabelistensammlung ändert.
PlaylistCollectionPlaylistAdded	Tritt auf, wenn der Wiedergabelistensammlung eine Wiedergabeliste hinzugefügt wird.
PlaylistCollectionPlaylistRemoved	Tritt auf, wenn eine Wiedergabeliste aus der Wiedergabelistensammlung entfernt wird.
PlaylistCollectionPlaylistSetAsDeleted	Für die zukünftige Verwendung reserviert.
PlayStateChange	Tritt auf, wenn sich der Wiedergabezustand des Windows Medienwiedergabe-Steuerelements ändert.
PositionChange	Tritt auf, wenn die aktuelle Position des Medienelements geändert wurde.
ScriptCommand	Tritt auf, wenn ein synchronisierter Befehl oder eine synchronisierte URL empfangen wird.
StatusChange	Tritt auf, wenn die status Eigenschaft den Wert ändert.
StringCollectionChange	Tritt auf, wenn sich eine Zeichenfolgenauflistung ändert.
Warning	Für die zukünftige Verwendung reserviert.

 

* Nicht zugänglich für Skins. Informationen zum Behandeln von Maus- und Tastaturereignissen in Skins finden Sie unter Umgebungsereignishandler.

Beim Eingebettet in eine Webseite kann auf das Player-Objekt mithilfe des im OBJECT-Tag angegebenen ID-Werts zugegriffen werden. Innerhalb einer Skindefinitionsdatei wird mithilfe des globalen Player-Attributs darauf zugegriffen. Zur Veranschaulichung wird der Player als Objekt-ID in den Abschnitten der Verweissyntax verwendet.

Siehe auch

Objektmodellreferenz für Skripterstellung