Método MediaCollection.getByAttribute

[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 getByAttribute recupera una lista de reproducción de elementos multimedia que contienen un valor especificado para un atributo especificado.

Sintaxis

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

Parámetros

atributo [in]

Cadena que indica el nombre del atributo que se va a buscar. Para obtener información sobre los atributos admitidos por Reproductor multimedia de Windows, consulte la referencia de atributos de Reproductor multimedia de Windows.

value [in]

Cadena que indica el valor que debe tener el atributo.

Valor devuelto

Este método devuelve un objeto Playlist .

Observaciones

Este método se puede usar para crear una consulta genérica para elementos multimedia que coincidan con un valor para un atributo de la base de datos. Esto es útil en el caso de atributos definidos por el usuario. Si el atributo no existe, se producirá un error.

Puede usar este método para recuperar todos los elementos multimedia de un tipo específico. Use el nombre de atributo "MediaType" y uno de los valores siguientes:

Value	Descripción
audio	Música y otros elementos de solo audio.
Reproducción	Listas de reproducción representadas como objetos Multimedia .
radio	Artículos de la estación de radio. No se usa en Reproductor multimedia de Windows 10.
video	Elementos de vídeo.
Foto	Artículos de fotos. Requiere Reproductor multimedia de Windows 10.
otro	Otros elementos, como archivos o direcciones URL de ASF para transmitir contenido multimedia.

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. getByAttribute para reproducir todo el contenido de la biblioteca por el artista llamado Triode 48. El objeto Player se creó con id. = "Player".

// 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();

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