ASX, élément

[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 ASX définit un fichier en tant que métafichier.

<ASX
   VERSION = "number"
   PREVIEWMODE = "YES" | "NO"
   BANNERBAR = "AUTO" | "FIXED"
>
</ASX>

Attributs

VERSION (requis)

Nombre décimal représentant le numéro de version de la syntaxe du métafichier. Défini sur 3 ou 3.0.

PREVIEWMODE (facultatif)

Valeur indiquant si Lecteur multimédia Windows passe en mode aperçu avant la lecture du premier clip.

Il doit s’agir de l’une des valeurs suivantes.

Valeur	Description
YES	Lecteur multimédia Windows passe en mode aperçu avant de lire le premier clip.
Non	Valeur par défaut. Lecteur multimédia Windows n’entre pas en mode aperçu avant la lecture du premier clip.

BANNERBAR (facultatif)

Valeur indiquant si Lecteur multimédia Windows réserve de l’espace pour un graphique de bannière.

Il doit s’agir de l’une des valeurs suivantes.

Valeur	Description
AUTO	Valeur par défaut. Lecteur multimédia Windows réserve de l’espace pour la barre de bannière uniquement lorsqu’un élément de contenu en inclut un.
FIXED	Lecteur multimédia Windows réserve un espace fixe pour un graphique de bannière pour chaque élément de contenu lu, qu’il y ait une bannière associée.

Éléments parent/enfant

Hierarchy	Éléments
Éléments parents	Aucun. L’élément ASX doit être le premier élément de chaque métafichier.
Éléments enfants	ABSTRACT, AUTHOR, BANNER, BASE, COPYRIGHT, ENTRY, ENTRYREF, EVENT, MOREINFO, PREVIEWDURATION, PARAM, REPEAT, TITLE

Notes

Les quatre premiers caractères d’une playlist de métafichier doivent être «< ASX ». D’autres éléments définis dans l’étendue de l’élément ASX, tels que TITLE et AUTHOR, sont associés aux informations d’affichage affichées par Lecteur multimédia Windows.

Pour Lecteur multimédia Windows, le numéro de version de la syntaxe est 3.0. Lecteur multimédia Windows prend en charge toutes les versions précédentes de la syntaxe de métafichier. Les valeurs acceptables pour l’attribut VERSION incluent 3.0 et 3 (sans virgule décimale).

Si la valeur de l’attribut PREVIEWMODE est OUI, Lecteur multimédia Windows passe immédiatement en mode aperçu avant de lire le premier clip. Lorsque Lecteur multimédia Windows passe en mode aperçu, il affiche un aperçu de chaque clip référencé dans le métafichier. L’élément PREVIEWDURATION détermine la durée de chaque préversion.

L’attribut BANNERBAR définit si Lecteur multimédia Windows réserve de l’espace pour un graphique de bannière. Une bannière est un graphique affiché dans la zone d’affichage vidéo pendant la lecture du contenu multimédia. (Utilisez l’élément BANNER pour ajouter une bannière au contenu.) Si la valeur de BANNERBAR est FIXE, Lecteur multimédia Windows réserve de l’espace de bannière pour chaque élément de contenu multimédia, que le contenu multimédia ait une bannière. Si aucune bannière n’est associée à un élément de contenu multimédia, l’espace réservé est noir. Si la valeur de l’attribut BANNERBAR est AUTO, Lecteur multimédia Windows réserve de l’espace pour la bannière uniquement lorsque le contenu multimédia en inclut un.

Si vous créez un métafichier avec plusieurs clips (éléments ENTRY ou ENTRYREF) et définissez la valeur de l’attribut BANNERBAR sur AUTO, Lecteur multimédia Windows pouvez redimensionner pour laisser de l’espace pour un graphique de bannière pour un clip, puis redimensionner à nouveau si le clip suivant ne contient pas de graphique de bannière. Si vous souhaitez que la taille de la fenêtre reste la même (sauf lorsque la taille de la vidéo change), utilisez la valeur FIXED pour l’attribut BANNERBAR .

L’espace réservé à un graphique de bannière est de 32 pixels de haut par 194 pixels de large. L’espace réservé apparaît sous n’importe quel contenu vidéo rendu et 6 pixels au-dessus du bord inférieur de la zone vidéo, ce qui permet d’espacer la bordure de la zone vidéo de 6 pixels. L’espace de bannière réservé est centré horizontalement.

Lecteur multimédia Windows affiche le graphique en commençant par le pixel le plus à gauche de l’espace de bannière. Si le graphique remplit l’espace entier, il apparaît centré horizontalement. Sinon, il y aura de l’espace de fin. Notez que la largeur minimale de Lecteur multimédia Windows est toujours supérieure à la taille du clip vidéo, quelle que soit la valeur de l’attribut BANNERBAR.

Exemples

<ASX VERSION="3.0" PREVIEWMODE="YES" BANNERBAR="auto"  >
   <ENTRY HREF="https://sample.microsoft.com/sample1.ASX" />
</ASX>

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 70 ou ultérieure

Voir aussi

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