Método MediaCollection.getByAlbum

[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 GetByAlbum recupera una lista de reproducción que contiene los elementos multimedia del álbum especificado.

Sintaxis

retVal = MediaCollection.getByAlbum(
  album
)

Parámetros

álbum [in]

Cadena que contiene el nombre del álbum.

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, vea Acceso a bibliotecas.

Ejemplos

En el ejemplo siguiente se usa MediaCollection. getByAlbum para recuperar una lista de reproducción de elementos multimedia. La lista de reproducción contiene elementos con el álbum especificado por el usuario en un elemento de entrada DE TEXTO HTML denominado GetAlbum. El objeto Player se creó con id. = "Player".

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

Requisitos

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

Consulte también

Objeto MediaCollection

Objeto Playlist

Settings.mediaAccessRights

Settings.requestMediaAccessRights