Élément PARAM

[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.]

L’élément PARAM définit un paramètre personnalisé associé à une playlist ou à un élément d’une playlist.

<PARAM
   NAME = "parameter name"
   VALUE = "parameter value"
/>

Paramètres

Un paramètre peut également être associé à l’affichage plutôt qu’à un clip individuel, en plaçant cet élément directement après la balise ASX . Ces éléments sont référencés par leur nom et une valeur d’index commençant par zéro.

Notes

Cet élément ASX est disponible uniquement pour Lecteur multimédia Windows version 6.01 et ultérieures. L’installation standard de Microsoft Internet Explorer 5 inclut une version compatible de Lecteur multimédia Windows.

Attributs

NAME

Nom utilisé pour accéder à la valeur du paramètre. Le nom peut être n’importe quelle chaîne valide. Les chaînes suivantes ont déjà été définies.

String Description
AllowShuffle L’attribut VALUE spécifie si la playlist de métafichier permet à la fonctionnalité de lecture aléatoire Lecteur multimédia Windows lecture aléatoire des entrées. L’attribut VALUE peut être défini sur « Oui » ou « Non ». La valeur par défaut est « Non ».
CanPause L’attribut VALUE spécifie si l’utilisateur peut suspendre la lecture. L’attribut VALUE peut être défini sur « Oui » ou « Non ». La valeur par défaut est « Oui ».
CanSeek L’attribut VALUE spécifie si l’utilisateur peut modifier la position de lecture actuelle à l’aide de la barre de recherche, de l’avance rapide ou de l’inverse rapide. L’attribut VALUE peut être défini sur « Oui » ou « Non ». La valeur par défaut est « Oui ».
CanSkipBack L’attribut VALUE spécifie si l’utilisateur peut revenir à l’élément de sélection précédent en cliquant sur Précédent. L’attribut VALUE peut être défini sur « Oui » ou « Non ». La valeur par défaut est « Oui ».
CanSkipForward L’attribut VALUE spécifie si l’utilisateur peut passer à l’élément de playlist suivant en cliquant sur Suivant. L’attribut VALUE peut être défini sur « Oui » ou « Non ». La valeur par défaut est « Oui ».
CPRadioID L’attribut VALUE spécifie l’ID d’un flux radio fourni par un magasin en ligne de type 1. Autrement dit, l’attribut VALUE doit être égal au champ RadioID de l’un des flux radio dans le catalogue du magasin en ligne. L’élément parent est l’élément ASX .
Encodage L’attribut VALUE est défini sur « utf-8 » pour indiquer que le métafichier est un fichier unicode (UTF-8).
HtmlFlink L’attribut VALUE est une chaîne fournie par un magasin en ligne de type 1. Lecteur multimédia Windows transmet la chaîne à la méthode IWMPContentPartner::GetItemInfo, qui est implémentée par le plug-in du magasin en ligne. La méthode GetItemInfo renvoie l’URL de la page web à afficher dans le volet En cours de lecture du lecteur. La page web a accès à toutes les méthodes que l’objet External expose aux magasins de type 1. Pour obtenir la liste de ces méthodes, consultez External Object for Type 1 Online Stores.
HTMLView L’attribut VALUE spécifie une URL qui s’affiche dans le volet En cours de lecture du lecteur en mode complet pour la durée de la playlist ou de l’entrée actuelle, selon que l’élément parent est l’élément ASX ou un élément ENTRY. HTMLView n’est pas pris en charge pour le contrôle Lecteur multimédia Windows.
Log:FieldName[:NameSpace] L’attribut VALUE spécifie la valeur sur laquelle le champ de journal indiqué sera défini. La partie :NameSpace de l’attribut NAME est facultative.
Prébuffer L’attribut VALUE spécifie si l’entrée de sélection suivante commence la mise en mémoire tampon avant la fin de l’entrée actuelle, ce qui permet une transition transparente. L’attribut VALUE peut être défini sur « true » ou « false ».
ShowWhileBuffering L’attribut VALUE spécifie si un fichier image référencé par l’élément ENTRY actuel continue à s’afficher au-delà de sa durée spécifiée pendant que l’entrée de sélection suivante est mise en mémoire tampon. L’attribut VALUE peut être défini sur « true » ou « false ».

VALUE

Valeur associée à ce paramètre. Il peut s’agir d’une valeur numérique ou d’une valeur de chaîne.

Éléments parent/enfant

Hierarchy Éléments
Éléments parents ASX, ENTRY
Éléments enfants None

Notes

Cet élément permet aux utilisateurs de placer des informations supplémentaires sur chaque clip à l’intérieur de l’élément ENTRY qui le contient. Pour récupérer les informations de métadonnées spécifiées dans l’entrée de la playlist, utilisez le média . Méthode getItemInfo . Média. La méthode getItemInfo récupère la valeur de l’attribut VALUE, en fonction du nom du paramètre. Les versions précédentes de Lecteur multimédia Windows récupèrent les informations de métadonnées spécifiées dans la playlist ENTRY, à l’aide de la méthode GetMediaParameter en fonction du nom du paramètre et d’un numéro d’index pour l’entrée.

Un paramètre peut également être associé à l’affichage plutôt qu’à un clip individuel, en plaçant cet élément directement après la balise ASX . Ces éléments sont référencés par leur nom et une valeur d’index commençant par zéro.

Remarque

Cet élément ASX est disponible uniquement pour Lecteur multimédia Windows version 6.01 et ultérieures. L’installation standard de Microsoft Internet Explorer 5 inclut une version compatible de Lecteur multimédia Windows.

Exemples

<ASX VERSION="3.0">
   <TITLE>Example Media Player Show</TITLE>
   <PARAM NAME="Director" VALUE="Jane D." />
   
   <ENTRY>
      <TITLE>Example Clip</TITLE>
      <REF HREF="https://sample.microsoft.com/media.asf" />
      <PARAM NAME="Location" VALUE="North America" />
      <PARAM NAME="Release Date" VALUE="March 1998" />
   </ENTRY>
   
   <ENTRY>
      <TITLE>Another Clip</TITLE>
      <REF HREF="https://sample.microsoft.com/more_media.asf" />
      <PARAM NAME="Location" VALUE="Japan">
      <PARAM NAME="Release Date" VALUE="December 1996" />
   </ENTRY>
</ASX>

Configuration requise

Condition requise Valeur
Version
Lecteur multimédia Windows version 7.0 ou ultérieure, Lecteur multimédia Windows série 9 ou ultérieure est requise pour les attributs NAME prédéfinis, Lecteur multimédia Windows 10 ou version ultérieure est requis pour les noms prédéfinis CanPause, CanSeek, CanSkipBack et CanSkipForward

Voir aussi

Affichage des pages web dans Lecteur multimédia Windows

Journalisation des données de flux

Informations de référence sur les éléments de métafichier Windows Media

Informations de référence sur les métafichiers Windows Media