Méthode MediaCollection.getByAttribute

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode getByAttribute récupère une playlist d’éléments multimédias qui contiennent une valeur spécifiée pour un attribut spécifié.

Syntaxe

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

Paramètres

attribut [in]

Chaîne indiquant le nom de l’attribut à rechercher. Pour plus d’informations sur les attributs pris en charge par Lecteur multimédia Windows, consultez la référence d’attribut Lecteur multimédia Windows.

value [in]

Chaîne indiquant la valeur que l’attribut doit avoir.

Valeur retournée

Cette méthode retourne un objet Playlist .

Notes

Cette méthode peut être utilisée pour créer une requête générique pour les éléments multimédias qui correspondent à une valeur pour un attribut dans la base de données. Cela est utile dans le cas d’attributs définis par l’utilisateur. Si l’attribut n’existe pas, une erreur se produit.

Vous pouvez utiliser cette méthode pour récupérer tous les éléments multimédias d’un type spécifique. Utilisez le nom d’attribut « MediaType » et l’une des valeurs suivantes :

Valeur	Description
audio	Musique et autres éléments audio uniquement.
Playlist	Playlists représentées en tant qu’objets Multimédia .
radio	Articles de station de radio. Non utilisé par Lecteur multimédia Windows 10.
video	Éléments vidéo.
Photo	Éléments photo. Nécessite Lecteur multimédia Windows 10.
other	Autres éléments, tels que des fichiers ASF ou des URL vers un média de diffusion en continu.

Pour utiliser cette méthode, un accès en lecture à la bibliothèque est requis. Pour plus d’informations, consultez Accès à la bibliothèque.

Exemples

L’exemple JScript suivant utilise MediaCollection. getByAttribute pour lire tout le contenu de la bibliothèque de l’artiste nommé Triode 48. L’objet Player a été créé avec l’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();

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Objet MediaCollection

Playlist, objet

Settings.mediaAccessRights

Settings.requestMediaAccessRights