PlaylistCollection.newPlaylist-Methode
[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.]
Die newPlaylist-Methode erstellt eine neue Wiedergabeliste in der Bibliothek.
Syntax
retVal = PlaylistCollection.newPlaylist(
name
)
Parameter
-
Name [in]
-
Zeichenfolge mit dem Namen der zu erstellenden Wiedergabeliste.
Rückgabewert
Diese Methode gibt ein Playlist-Objekt zurück.
Bemerkungen
Diese Methode erstellt eine leere Wiedergabeliste in der Bibliothek. Um die Wiedergabeliste mit Medienelementen zu füllen, verwenden Sie Wiedergabeliste. appendItem oder Playlist. insertItem.
Mehrere Wiedergabelisten mit demselben Namen sind in der Bibliothek zulässig. Um das Erstellen eines doppelten Wiedergabelistennamens mit dieser Methode zu vermeiden, verwenden Sie getByName und PlaylistArray. count , um zu bestimmen, ob eine Wiedergabeliste mit einem bestimmten Namen bereits vorhanden ist.
Führende und nachfolgende Leerzeichen sind in Wiedergabelistennamen nicht zulässig und werden automatisch aus dem für den name-Parameter angegebenen Wert entfernt.
Um diese Methode verwenden zu können, ist voller Zugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.
Beispiele
Im folgenden JScript-Beispiel wird eine neue leere Wiedergabeliste namens "ThreeList" erstellt. Das Player-Objekt wurde mit ID="Player" erstellt.
//Add a new empty playlist, named ThreeList, to the playlist collection.
var NewList = Player.playlistCollection.newPlaylist("ThreeList");
Anforderungen
Anforderung | Wert |
---|---|
Version |
Windows Medienwiedergabe Version 7.0 oder höher. |
DLL |
|
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für