MediaCollection.getByAuthor-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 getByAuthor-Methode ruft eine Wiedergabeliste der Medienelemente des angegebenen Autors ab.

Syntax

retVal = MediaCollection.getByAuthor(
  author
)

Parameter

Autor [in]

Zeichenfolge , die den Namen des Autors enthält.

Rückgabewert

Diese Methode gibt ein Playlist-Objekt zurück.

Bemerkungen

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

Beispiele

Im folgenden JScript-Beispiel wird MediaCollection verwendet. getByAuthor , um eine Wiedergabeliste mit Medienelementen abzurufen. Die Wiedergabeliste enthält Elemente, die dem Autor entsprechen, der vom Benutzer in einem HTML TEXT-Eingabeelement namens GetAuthor angegeben wurde. Das Player-Objekt wurde mit der ID = "Player" erstellt.

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

onClick = "
    /* Retrieve the author name text from the user. */
    var author = GetAuthor.value;

    /* Create the playlist by using getByAuthor. */
    var pl = Player.mediaCollection.getByAuthor(Author);

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

    /* Play the media items 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