Wiedergabelisten und das PlaylistCollection-Objekt
Das PlaylistCollection-Objekt bietet Ihnen Zugriff auf Wiedergabelisten in der Bibliothek und verfügt über Methoden zum Erstellen neuer, leerer Wiedergabelisten und neuer Wiedergabelisten aus Metadateien.
Arbeiten mit vorhandenen Wiedergabelisten
Die PlaylistCollection. getAll und PlaylistCollection. getByName-Methoden geben jeweils ein PlaylistArray-Objekt zurück, das mehrere Wiedergabelisten enthalten kann.
Die PlaylistCollection. Die getAll-Methode gibt alle vorhandenen Wiedergabelisten zurück, die sich in der Bibliothek befinden. Beispielsweise können Sie diese Methode aufrufen und dann die Wiedergabelisten im PlaylistArray-Objekt abrufen, um zu bestimmen, ob bereits ein angegebener Wiedergabelistenname verwendet wurde, oder um dem Benutzer alle Wiedergabelisten anzuzeigen. Der Beispielcode in Playlist Attributes verwendet die getAll-Methode.
Die PlaylistCollection. Die getByName-Methode gibt alle Wiedergabelisten mit einem angegebenen Namen zurück. Sie können diese Methode verwenden, um jede dieser Wiedergabelisten separat zu behandeln.
Sie können auch die getByName-Methode verwenden, um eine eindeutige Wiedergabeliste nach Namen abzurufen. In diesem Fall verfügt das PlaylistArray-Objekt nur über ein Element. Im folgenden C#-Beispiel wird diese Technik veranschaulicht.
IWMPPlaylistArray PlayListArray;
IWMPPlaylist Playlist;
// Store the playlist named "BluesTest" in the array
PlayListArray = Player.playlistCollection.getByName("BluesTest");
// Retrieve the first playlist in the collection.
Playlist = PlaylistArray.Item(0);
Arbeiten mit neuen Wiedergabelisten
Sie können die PlaylistCollection verwenden. newPlaylist-Methode zum Erstellen einer neuen, leeren Wiedergabeliste. Die -Methode gibt einen Verweis auf das neue Playlist-Objekt zurück. Anschließend können Sie die Wiedergabeliste aufrufen. appendItem-Methode zum Hinzufügen von Medienelementen zur Wiedergabeliste.
Sie können auch eine neue Wiedergabeliste basierend auf einer Wiedergabelistenmetadatei erstellen. Übergeben Sie zunächst den Namen der Wiedergabeliste und den Pfad zur Metadatei an den Player. newPlaylist-Methode. Diese Methode gibt einen Verweis auf das neue Playlist-Objekt zurück. Übergeben Sie dann das neue Playlist-Objekt an die PlaylistCollection. importPlaylist-Methode, um sie der Bibliothek hinzuzufügen.
Beachten Sie den Unterschied zwischen der PlaylistCollection. newPlaylist-Methode und player. newPlaylist-Methode. Die PlaylistCollection-Methode erstellt eine neue leere Wiedergabeliste und fügt sie der Bibliothek hinzu. Die Player-Methode erstellt ein neues, aufgefülltes Playlist-Objekt, fügt es jedoch nicht zur Bibliothek hinzu.
In diesem Thema wurde das Player-Objekt wie folgt definiert:
AxWMPLib.AxWindowsMediaPlayer Player;
using WMPLib;
Im folgenden C#-Beispiel wird das Importieren einer Wiedergabeliste aus einer Metadatei veranschaulicht. Das argument strPListName gibt den Namen der neuen Wiedergabeliste an. StrMetaFileName gibt den Namen der Metadatei an, aus der die Wiedergabeliste importiert wird.
private IWMPPlaylist importPlaylist(string strPlaylistName, string strMetaFileName)
{
IWMPPlaylist NewPlaylist;
IWMPPlaylist ImportPlaylist;
NewPlaylist = Player.newPlaylist(strPlaylistName, strMetaFileName);
ImportPlaylist = Player.playlistCollection.importPlaylist(NewPlaylist);
return ImportPlaylist;
}