Método MediaCollection.getByAttribute

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 .

Comentarios

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 JScript siguiente 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 Valor
Versión
Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL
Wmp.dll

Vea también

Objeto MediaCollection

Playlist (objeto)

Configuración.mediaAccessRights

Configuración.requestMediaAccessRights