Método MediaCollection.getByAuthor

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método getByAuthor recupera una lista de reproducción de los elementos multimedia del autor especificado.

Sintaxis

retVal = MediaCollection.getByAuthor(
  author
)

Parámetros

author [in]

Cadena que contiene el nombre del autor.

Valor devuelto

Este método devuelve un objeto Playlist .

Observaciones

Para usar este método, se requiere acceso de lectura a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.

Ejemplos

En el ejemplo siguiente de JScript se usa MediaCollection. getByAuthor para recuperar una lista de reproducción de elementos multimedia. La lista de reproducción contiene elementos que coinciden con el autor especificado por el usuario en un elemento de entrada TEXT HTML denominado GetAuthor. El objeto Player se creó con id. = "Player".

<!-- 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();
">

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Objeto MediaCollection

Playlist (objeto)

Settings.mediaAccessRights

Settings.requestMediaAccessRights