Verwalten von Medienelementen

  • Artikel

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

Ein Media-Objekt stellt ein Medienelement dar. Es verfügt über Eigenschaften und Methoden, die Sie verwenden können, um Informationen abzurufen und dem Benutzer anzuzeigen, oder um verschiedene Aktionen basierend auf dem abgerufenen Wert auszuführen.

Ein Großteil Ihrer Arbeit mit Media-Objekten umfasst Metadaten zum Inhalt des Medienelements, die als Attribute bezeichnet werden. Im Thema Medienelementattribute wird beschrieben, wie Attributwerte gelesen und geändert werden. Zusätzlich zu diesem Thema finden Sie in den Richtlinien zur Verwendung von Windows Media-Metadaten auf der Microsoft-Website weitere Informationen zu den Attributen und deren Verwendung.

Das Media-Objekt verfügt über Eigenschaften und Methoden, die einige Attribute direkt abrufen, z. B. den Namen oder die Dauer des Elements. Bei Videoelementen können Sie die Höhe und Breite des Bilds abrufen und Markerinformationen basierend auf dem Namen oder Index eines Markers abrufen. Sie können auch bestimmen, ob ein bestimmtes Medienelement in einer bestimmten Wiedergabeliste enthalten ist.

Abrufen eines Medienobjekts

Sie können schnell auf das aktuelle Medienelement zugreifen, indem Sie den Player verwenden. currentMedia-Eigenschaft .

In diesem Thema wurde das Player-Objekt wie folgt definiert:

AxWMPLib.AxWindowsMediaPlayer Player;
using WMPLib;

Im folgenden C#-Beispiel wird ein Media-Objekt abgerufen, das das aktuelle Element darstellt.

IWMPMedia media;
media = Player.currentMedia;

Sie können ein neues Medienelement aus einer digitalen Mediendatei erstellen, indem Sie den Player verwenden. newMedia-Methode . Sie übergeben der Methode den URL-Pfad an eine digitale Mediendatei, und sie gibt einen Verweis auf das neue Media-Objekt zurück. Die -Methode fügt das neue Objekt der Bibliothek nicht direkt hinzu. Sie können das Objekt jedoch an die Wiedergabeliste übergeben. appendItem-Methode oder die Playlist. insertItem-Methode .

Im folgenden C#-Beispiel wird ein Media-Objekt basierend auf einem der digitalen Medienbeispiele erstellt, die mit dem Windows Medienwiedergabe SDK installiert wurden.

IWMPMedia media;
media = Player.newMedia("C:\\WMSDK\\WMPSDK10\\samples\\media\\laure.wma");

Hinweis

Sie müssen zwei umgekehrte Schrägstriche (\) (oder das @-Zeichen in C#) in eine Zeichenfolge einschließen, um ein tatsächliches umgekehrtes Schrägstrichzeichen darzustellen. Dies liegt daran, dass C# einen einzelnen umgekehrten Schrägstrich verwendet, um eine Escapesequenz zu definieren.

 

Sie können ein neues Medienelement aus einer digitalen Mediendatei erstellen und in einem Schritt der Bibliothek hinzufügen, indem Sie die MediaCollection verwenden. Add-Methode . Wie der Player. newMedia-Methode : Die add-Methode nimmt einen Pfad zu einer digitalen Mediendatei an.

Im folgenden C#-Beispiel wird ein Media-Objekt basierend auf einer der SDK-Beispieldateien erstellt und dieses Objekt der Bibliothek hinzugefügt.

IWMPMedia media;
media = Player.mediaCollection.add("C:\\WMSDK\\WMPSDK10\\samples\\media\\laure.wma");

Sie können ein Media-Objekt abrufen, das ein Medienelement in einer Wiedergabeliste darstellt, indem Sie die Wiedergabeliste verwenden. item-Methode . Im folgenden C#-Beispiel wird das sechste Medienelement aus der aktuellen Wiedergabeliste abgerufen.

IWMPMedia media;
media = Player.currentPlaylist.get_Item(5);

Controls.currentItem

Verwalten von Wiedergabelisten

Medienobjekt

MediaCollection.add

Player.currentMedia

Player.newMedia

Playlist.item

Arbeiten mit der Bibliothek