Controls.playItem-Methode

[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.]

Die playItem-Methode gibt das angegebene Medienelement ab.

Syntax

Controls.playItem(
  theMediaItem
)

Parameter

theMediaItem [in]

Medienobjekt , das wiedergegeben werden soll.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Das Medienelement wird automatisch geladen und wiedergegeben, unabhängig vom Wert der Einstellungen. autoStart-Eigenschaft . Um ein Element zu laden, ohne es automatisch abzuspielen, legen Sie Einstellungen fest. AutoStart auf false, und Weisen Sie Player einen Wert zu. URL, nach der die Wiedergabe aufgerufen werden kann, um mit der Wiedergabe des Elements zu beginnen.

Hinweis

playItem funktioniert nur mit Elementen in currentPlaylist. Das Aufrufen von playItem mit einem Verweis auf ein gespeichertes Medienelement wird nicht unterstützt.

Beispiele

Im folgenden JScript-Beispiel wird playItem verwendet, um ein Medienelement aus der aktuellen Wiedergabeliste wiederzugeben. Das element, das wiedergegeben werden soll, wird basierend auf seiner Position in der Wiedergabeliste ausgewählt. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// Declare a variable to hold the position of the media item 
// in the current playlist. An arbitrary value is supplied here.
var index = 3

// Retrieve the media item at the fourth position in the current playlist.
var media = Player.currentPlaylist.item(index);

// Play the media item.
Player.controls.playItem(media);

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

Controls-Objekt

Playlist.item