MediaCollection.getByAlbum-Methode

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

Die GetByAlbum-Methode ruft eine Wiedergabeliste ab, die die Medienelemente aus dem angegebenen Album enthält.

Syntax

retVal = MediaCollection.getByAlbum(
  album
)

Parameter

Album [in]

Zeichenfolge , die den Namen des Albums enthält.

Rückgabewert

Diese Methode gibt ein Playlist-Objekt zurück.

Hinweise

Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Beispiele

Im folgenden Beispiel wird MediaCollection verwendet. getByAlbum , um eine Wiedergabeliste mit Medienelementen abzurufen. Die Wiedergabeliste enthält Elemente mit dem Album, das vom Benutzer in einem HTML-TEXT-Eingabeelement namens GetAlbum angegeben wurde. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<!-- Use an HTML BUTTON element to create the playlist and 
then play the digital media items. -->
<INPUT TYPE = "BUTTON"
       NAME = "PlayAlbum" 
       ID = "PlayAlbum"  
       VALUE = "Play Album"

onClick = "
    /* Retrieve the album title text from the user. */
    var album = GetAlbum.value;

    /* Create the playlist using getByAlbum. */
    var pl = Player.mediaCollection.getByAlbum(album);

    /* Make the new playlist the current playlist. */
    Player.currentPlaylist = pl;

    /* Play the media in the new playlist. */
    Player.controls.play();
">

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

MediaCollection-Objekt

Wiedergabelistenobjekt

Settings.mediaAccessRights

Settings.requestMediaAccessRights