ÉLÉMENT EVENT

[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 EVENT définit un comportement ou une action effectuée par Lecteur multimédia Windows lorsqu’il reçoit une commande de script étiquetée en tant qu’événement.

<EVENT   
   NAME = "text string"
   WHENDONE = "RESUME" | "NEXT" | "BREAK"
>
</EVENT>

Attributs

NAME (obligatoire)

Nom de l’événement.

WHENDONE (obligatoire)

Valeur qui définit ce que Lecteur multimédia Windows fait après la lecture du contenu référencé.

Les valeurs suivantes sont possibles.

Valeur	Description
RESUME	L’entrée actuelle (le clip interrompu par l’événement) reprend la lecture. Si le contenu est stocké, il reprend au même point où il s’est arrêté ; si le contenu est diffusé, il reprend à la position actuelle.
NEXT	L’élément ENTRY suivant se lit comme si l’événement ne s’était pas produit et Lecteur multimédia Windows avait atteint la fin du clip actuel.
BREAK	Si l’entrée actuelle se trouve dans une boucle REPEAT , la boucle se termine comme si le nombre de répétitions était terminé. Sinon, Lecteur multimédia Windows passe à la fin de la playlist comme si la dernière entrée s’était terminée comme d’habitude.

Éléments parent/enfant

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

Notes

Cet élément définit un comportement ou une action effectuée par Lecteur multimédia Windows lorsqu’il reçoit une commande de script étiquetée en tant qu’événement. Un événement est un type particulier de commande de script incorporé dans un flux envoyé à Lecteur multimédia Windows qui se compose d’une chaîne double. La première chaîne est le mot « event », et la deuxième chaîne est le nom de l’événement. Le nom de l’événement dans la deuxième chaîne doit correspondre au nom d’événement défini dans le métafichier. (La correspondance ne respecte pas la casse.) Les événements peuvent être envoyés à Lecteur multimédia Windows recevant un flux en temps réel, ou peuvent être enregistrés dans un fichier .asf, .wma ou .wmv qui est remis en tant que flux de monodiffusion à la demande. Quand Lecteur multimédia Windows reçoit la commande de script, il traite l’événement comme défini par l’élément EVENT.

Cet élément définit une étendue d’éléments ENTRY ou ENTRYREF qui sont traités chaque fois que Lecteur multimédia Windows reçoit la commande de script avec l’événement nommé. ENTRYREF peut être une URL qui pointe vers une page ASP. Avec cet élément, vous pouvez spécifier un comportement pour le basculement de flux en quasi-temps réel, par opposition aux modifications de flux pré-créées à l’aide de références à d’autres éléments de contenu ou à des métafichiers Windows Media.

Lorsque vous utilisez des pages ASP pour générer des playlists, vous devez spécifier une valeur pour la réponse. Propriété ContentType et Response. expire la propriété dans la page ASP en raison de problèmes de latence avec Lecteur multimédia Windows. Réponse. ContentType doit être une extension de nom de fichier valide pour les métafichiers Windows Media. Les types valides incluent .asf, .asx, .wma, .wax, .wmv et .wvx.

Consultez le Kit de développement logiciel (SDK) de plateforme pour plus d’informations sur l’utilisation de l’objet Response dans ASP.

Cet élément peut apparaître n’importe où dans l’élément ASX . Si plusieurs éléments EVENT au sein d’un élément ASX ont des valeurs identiques pour leurs attributs NAME, Lecteur multimédia Windows utilise la première occurrence dans l’élément ASX et ignore toutes les autres. Lorsque les éléments EVENT ont des attributs NAME distincts, leur ordre au sein de l’élément ASX n’a pas d’importance.

Lecteur multimédia Windows ignore les événements qu’il reçoit lors du traitement d’un autre événement. L’imbrication d’événements n’est pas prise en charge. Lorsque Lecteur multimédia Windows est en mode aperçu, le contenu de l’événement n’est pas limité par l’élément PREVIEWDURATION ; la longueur complète du contenu de l’événement peut être lue même si la durée d’aperçu de l’élément ENTRY actif expire avant la fin de l’événement.

Exemples

Dans cet exemple, quand Lecteur multimédia Windows reçoit la commande de script EVENT et la chaîne de commande « Adlink » dans le média de diffusion en continu qu’il affiche, il recherche un EVENTNAME « Adlink ». Lecteur multimédia Windows bascule à partir du flux qu’il affiche et lit le contenu référencé dans l’ÉVÉNEMENT, « https://example.microsoft.com/adlink.htm".

L’attribut ENTRYCLIENTSKIP est défini sur NON pour empêcher l’enregistrement du clip EVENT . Elle doit être jouée.

Le script WHENDONE="RESUME" indique Lecteur multimédia Windows de reprendre la lecture du média précédent à partir duquel il a basculé dès qu’Adlink.asf est terminé.

<ASX VERSION="3.0">
<ENTRY CLIENTSKIP="NO">
   <REF HREF="https://example.microsoft.com/clip1.asf" />
</ENTRY>
<EVENT NAME="Adlink" WHENDONE="RESUME">
   <ENTRYREF HREF="https://example.microsoft.com/adlink.htm" 
       CLIENTSKIP="NO" />
</EVENT>
</ASX>

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 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

modèle objet Lecteur multimédia Windows