MediaCollection.getByAttribute-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 getByAttribute-Methode ruft eine Wiedergabeliste von Medienelementen ab, die einen angegebenen Wert für ein angegebenes Attribut enthalten.
Syntax
retVal = MediaCollection.getByAttribute(
attribute,
value
)
Parameter
-
Attribut [in]
-
Zeichenfolge , die den Namen des zu durchsuchenden Attributs angibt. Informationen zu den von Windows Medienwiedergabe unterstützten Attributen finden Sie in der Windows Medienwiedergabe-Attributreferenz.
-
Wert [in]
-
Zeichenfolge , die den Wert angibt, den das Attribut haben soll.
Rückgabewert
Diese Methode gibt ein Playlist-Objekt zurück.
Hinweise
Diese Methode kann verwendet werden, um eine generische Abfrage für Medienelemente zu erstellen, die einem Wert für ein Attribut in der Datenbank entsprechen. Dies ist bei benutzerdefinierten Attributen nützlich. Wenn das Attribut nicht vorhanden ist, tritt ein Fehler auf.
Sie können diese Methode verwenden, um alle Medienelemente eines bestimmten Typs abzurufen. Verwenden Sie den Attributnamen "MediaType" und einen der folgenden Werte:
Wert | BESCHREIBUNG |
---|---|
Audio | Musik und andere reine Audioelemente. |
Playlist | Wiedergabelisten, die als Medienobjekte dargestellt werden. |
radio | Radiosenderelemente. Wird von Windows Medienwiedergabe 10 nicht verwendet. |
video | Videoelemente. |
Foto | Fotoelemente. Erfordert Windows Medienwiedergabe 10. |
Andere | Andere Elemente, z. B. ASF-Dateien oder URLs für Streamingmedien. |
Um diese Methode verwenden zu können, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.
Beispiele
Im folgenden JScript-Beispiel wird MediaCollection verwendet. getByAttribute , um alle Inhalte aus der Bibliothek des Künstlers triode 48 wiederzugeben. Das Player-Objekt wurde mit der ID = "Player" erstellt.
// Get a playlist object filled with media items by a
// particular artist.
var pl = Player.mediaCollection.getByAttribute("Artist", "Triode 48");
// Make the new playlist the current one.
Player.currentPlaylist = pl;
// Start Windows Media Player.
Player.controls.play();
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