Programmgesteuerter Zugriff auf die Bibliothek
Im Code wird die Bibliothek durch das MediaCollection-Objekt (oder die IWMPMediaCollection-Schnittstelle) dargestellt. Medienelemente werden als Medienobjekte (oder durch die IWMPMedia-Schnittstelle) dargestellt. Wiedergabelistenelemente werden als Wiedergabelistenobjekte (oder durch die IWMPPlaylist-Schnittstelle) dargestellt. Der Einfachheit halber bezieht sich dieser Abschnitt nach Möglichkeit einfach auf Objektnamen.
Mithilfe des MediaCollection-Objekts können Sie mit Medienelementen und Wiedergabelisten arbeiten. Die Bibliothek macht auch das PlaylistCollection-Objekt (oder die IWMPPlaylistCollection-Schnittstelle) verfügbar, das einige Funktionen speziell für die Arbeit mit Wiedergabelisten bietet. In den meisten Jahren stellt das MediaCollection-Objekt Ihnen die Funktionalität zur Verfügung, die Sie benötigen, auch wenn Sie mit Wiedergabelisten arbeiten. Weitere Informationen zum Arbeiten mit Medienelementen finden Sie unter Verwalten von Medienelementen. Weitere Informationen zum Arbeiten mit Wiedergabelisten finden Sie unter Verwalten von Wiedergabelisten.
Hinzufügen von Medienelementen zur Bibliothek
Das Hinzufügen digitaler Medieninhalte zur Bibliothek ist einfach. Rufen Sie einfach die MediaCollection.add-Methode auf, und geben Sie den Pfad zur Mediendatei als Argument an.
Abrufen von Medienelementen aus der Bibliothek
Wenn Sie Medienelemente aus der Bibliothek abrufen, ist das, was Sie tatsächlich abrufen, eine Wiedergabeliste. Auch wenn Sie nur ein Medienelement abrufen möchten, erhalten Sie ein Playlist-Objekt, das ein einzelnes Element enthält, das index 0 zugeordnet wird. Wenn Sie z. B. ein Media-Objekt abrufen möchten, das den Titel mit dem Namen "Soll" darstellt, können Sie den folgenden JScript verwenden:
// Retrieve media named Jeanne from the library.
var playlist = player.mediaCollection.getByName("Jeanne");
Der vorangehende Code ruft eine Wiedergabeliste ab, die alle Medienelemente mit dem Namen "Dabei" als Titel enthält. In diesem Beispiel wird davon ausgegangen, dass sie wissen, dass nur ein Titel mit diesem Namen in der Bibliothek verfügbar ist (beachten Sie, dass die Bibliothek mehrere Titel mit dem gleichen Namen unterstützt). Dies bedeutet, dass Sie erwarten können, dass die Anzahl der Elemente in der Wiedergabeliste, die Sie abgerufen haben, gleich 1 ist und das Medienelement durch Index 0 dargestellt wird. Der folgende Beispielcode setzt das vorherige Beispiel fort, um zu veranschaulichen, wie Sie das Medienelement mithilfe der Playlist.item-Methode aus der Wiedergabeliste abrufen würden.
// Retrieve the individual media item from the playlist.
var media = playlist.item(0);
Weitere Informationen zum Abrufen von Medienelementen aus Wiedergabelisten finden Sie unter Wiedergabelisten und Medienelemente im Player-Steuerelementhandbuch.
Abrufen von Metadaten aus einem Medienelement
Nachdem Sie ein Media-Objekt abgerufen haben, können Sie die Attributwerte lesen, die dem Inhalt zugeordnet sind. Im einfachsten Fall möchten Sie vielleicht einfach nur einen einzelnen Wert kennen, z. B. den Namen des Interpreten, der eine Musikspur durchgeführt hat. Das folgende JScript zeigt, wie Sie die Media.getItemInfo-Methode verwenden, um den Namen des Interpreten aus den medien abzurufen, die im vorherigen Beispiel abgerufen wurden:
// Retrieve the artist name string.
var author = media.getItemInfo("Artist");
Ein Medienelement kann viele verschiedene Attribute haben, und das Arbeiten mit Metadaten ist nicht immer so einfach wie der einfache Fall, der im vorherigen Beispiel gezeigt wurde. Einige Attribute können beispielsweise mehrere Werte oder Werte in mehreren Sprachen enthalten. Weitere Informationen zum Arbeiten mit Metadaten finden Sie unter Media Item Attributes. Weitere Informationen zu den verschiedenen Attributen, ihren Bedeutungen und der Unterstützung von Dateitypen finden Sie in der Attributreferenz.
Entfernen von Medienelementen aus der Bibliothek
Das Entfernen digitaler Medieninhalte aus der Bibliothek ist ebenfalls einfach. Rufen Sie einfach MediaCollection.remove auf, und geben Sie dabei das Media-Objekt an, das das Element als erstes Argument und den Wert true als zweites darstellt. Im folgenden JScript Beispiel wird die Datei mit dem Namen "Muss" (abgerufen im vorherigen Beispiel) aus der Bibliothek entfernt:
// Remove Jeanne from the library.
playst.mediaCollection.remove(media, true);