Wiedergabelisten und das MediaCollection-Objekt

Das MediaCollection-Objekt bietet Ihnen Zugriff auf eine Vielzahl von speziellen Wiedergabelisten und enthält eine Methode zum Erstellen einer neuen Wiedergabeliste aus einer Metadatei.

Die folgenden Methoden rufen spezielle Wiedergabelisten ab:

  • getAll
  • getBy Auserkennen
  • getByAttribute
  • getByAuthor
  • getByGenre
  • getByName

Wie ihre Namen vermuten lassen, rufen diese Methoden Wiedergabelisten ab, die alle Medienelemente in der Bibliothek enthalten, die bestimmten Kriterien entsprechen.

Achten Sie darauf, die MediaCollection nicht zu verwechseln. getByName-Methode mit der PlaylistCollection. getByName-Methode. Die MediaCollection-Methode gibt ein Playlist-Objekt zurück, das alle Medienelemente mit dem angegebenen Namen enthält. Die PlaylistCollection-Methode gibt ein PlaylistArray-Objekt zurück, das alle Wiedergabelisten mit dem angegebenen Namen enthält.

Sie können mediaCollection verwenden. add-Methode zum Hinzufügen von Wiedergabelisten und Medienelementen zur Bibliothek. Um eine Wiedergabeliste hinzuzufügen, übergeben Sie der -Methode den Pfad zur Metadatei, die die Wiedergabeliste definiert. Die -Methode gibt immer ein Media-Objekt zurück. Sie können keine Umwandlung zwischen Medien- und Wiedergabelistenobjekten erstellen. Um mit der wiedergabeliste zu arbeiten, die Sie hinzugefügt haben, rufen Sie das Wiedergabelistenobjekt ab, das den gleichen Namen wie das Media-Objekt hat.

Im folgenden C#-Beispiel wird veranschaulicht, wie Medien mithilfe von MediaCollection vom Typ abgerufen werden. getByAttribute-Methode. Dieser Code ruft die Namen aller Attribute ab, die einem bestimmten Typ zugeordnet sind, sowie den Lese-/Schreibstatus oder den schreibgeschützten Status dieser Attribute. Es wird eine einzelne Datei generiert, die Listen mit Attributen für die Typen Audio, Video, Radio, Playlist, Other, Musik und Photo enthält.

string strOutFile = "AttribList.txt";    // Name of the output file
...
StreamWriter sw = new StreamWriter(strOutFile, true);

sw.Write(getMediaCollectionNames("Audio"));
sw.Write(getMediaCollectionNames("Video"));
sw.Write(getMediaCollectionNames("Radio"));
sw.Write(getMediaCollectionNames("Playlist"));
sw.Write(getMediaCollectionNames("Other"));
sw.Write(getMediaCollectionNames("Music"));
sw.Write(getMediaCollectionNames("Photo"));
sw.Close();
...
// The getMediaCollection method retrieves the names of
// all attributes for a specified type.
private string getMediaCollectionNames(string sSchema)
{
IWMPPlaylist playlist;
IWMPMedia media;
string strResult = "";    // Cumulative list of attributes
string strAttrName = "";  // Attribute name
string strReadWrite = ""; // Read/Write status of attribute
int iAttrCount = 0;       // Count of playlist attributes

// Retrieve a playlist corresponding to the requested type.
playlist = Player.mediaCollection.getByAttribute("MediaType", sSchema);

// Initialize the result string
strResult += "\n" + sSchema.ToString() + " Schema: \n";

// Retrieve the attributes for the playlist
if (playlist.count != 0)
{
    media = playlist.get_Item(0);
    iAttrCount = media.attributeCount;
    for (int i = 0; i < iAttrCount; i++)
    {
        strAttrName = media.getAttributeName(i);
        strResult += "   " + strAttrName  +"\n";
        if (media.isReadOnlyItem(strAttrName))
            strReadWrite = "Read Only";
        else
            strReadWrite = "Read/Write";
        strResult += "         " + strReadWrite + "\n";
    }
}

return strResult;
}

Im folgenden C#-Beispiel wird veranschaulicht, wie Sie der Bibliothek eine Wiedergabeliste aus einer Metadatei hinzufügen.

// Add a playlist as a media item
IWMPMedia Media = Player.mediaCollection.add("c:\\testPlayList.asx");

Statische Wiedergabelisten enthalten bestimmte Medienelemente. Automatische Wiedergabelisten durchsuchen die Bibliothek jedes Mal, wenn sie geöffnet werden, und können unterschiedliche Medienelemente zu unterschiedlichen Zeiten enthalten. Sie können der Bibliothek mithilfe von MediaCollection sowohl statische als auch automatische Wiedergabelisten hinzufügen. add-Methode. Sie können statische Wiedergabelisten auch mithilfe der PlaylistCollection hinzufügen. importPlaylist-Methode.

Verwalten von Wiedergabelisten

MediaCollection-Objekt

Wiedergabelistenobjekt

PlaylistCollection-Objekt

Wiedergabelisten und das PlaylistCollection-Objekt

Statische und automatische Wiedergabelisten