Elemento EVENT

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El elemento EVENT define un comportamiento o una acción realizada por Reproductor multimedia de Windows cuando recibe un comando de script etiquetado como un evento.

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

Atributos

NAME (obligatorio)

Nombre del evento.

WHENDONE (obligatorio)

Valor que define lo que Reproductor multimedia de Windows hace después de reproducir el contenido al que se hace referencia.

Los siguientes valores son posibles.

Value	Descripción
RESUME	La entrada actual (el clip interrumpido por el evento) reanuda la reproducción. Si el contenido se almacena, se reanuda en el mismo punto donde se detuvo; si el contenido se difunde, se reanuda en la posición actual.
NEXT	El siguiente elemento ENTRY se reproduce como si el evento no se hubiera producido y Reproductor multimedia de Windows hubiera llegado al final del clip actual.
BREAK	Si la entrada actual está dentro de un bucle REPEAT , el bucle finaliza como si se hubiera completado el recuento de repeticiones. De lo contrario, Reproductor multimedia de Windows salta al final de la lista de reproducción como si la entrada final se hubiera completado como de costumbre.

Elementos primarios o secundarios

Hierarchy	Elementos
Elementos primarios	ASX
Elementos secundarios	ENTRY, ENTRYREF

Observaciones

Este elemento define un comportamiento o una acción realizada por Reproductor multimedia de Windows cuando recibe un comando de script etiquetado como un evento. Un evento es un tipo determinado de comando de script incrustado en una secuencia enviada a Reproductor multimedia de Windows que consta de una cadena doble. La primera cadena es la palabra "event" y la segunda cadena es el nombre del evento. El nombre del evento de la segunda cadena debe coincidir con el nombre de evento definido en el metarchivo. (La coincidencia no distingue mayúsculas de minúsculas). Los eventos se pueden enviar a Reproductor multimedia de Windows recibir una secuencia en tiempo real o se pueden guardar en un archivo .asf, .wma o .wmv que se entrega como una secuencia de unidifusión a petición. Cuando Reproductor multimedia de Windows recibe el comando script, procesa el evento según lo definido por el elemento EVENT.

Este elemento define un ámbito de los elementos ENTRY o ENTRYREF que se procesan siempre que Reproductor multimedia de Windows recibe el comando de script con el evento con nombre. ENTRYREF puede ser una dirección URL que apunta a una página ASP. Con este elemento, puede especificar un comportamiento para el cambio de secuencia casi en tiempo real, en lugar de cambios de secuencia creados previamente mediante referencias a otros elementos de contenido o metarchivos de Windows Media.

Al usar páginas ASP para generar listas de reproducción, debe especificar un valor para la respuesta. Propiedad ContentType y Response. expira la propiedad en la página ASP debido a problemas de latencia con Reproductor multimedia de Windows. Respuesta.ContentType debe ser una extensión de nombre de archivo válida para los metarchivos de Windows Media. Los tipos válidos incluyen .asf, .asx, .wma, .wax, .wmv y .wvx.

Consulte El SDK de plataforma para obtener más información sobre el uso del objeto Response en ASP.

Este elemento puede aparecer en cualquier parte del elemento ASX . Si varios elementos EVENT dentro de un elemento ASX tienen valores idénticos para sus atributos NAME, Reproductor multimedia de Windows usa la primera aparición dentro del elemento ASX y omite todos los demás. Cuando los elementos EVENT tienen atributos NAME distintos, su orden dentro del elemento ASX no importa.

Reproductor multimedia de Windows descarta los eventos que recibe al procesar otro evento. No se admite el anidamiento de eventos. Cuando Reproductor multimedia de Windows está en modo de vista previa, el contenido del evento no está restringido por el elemento PREVIEWDURATION; la longitud completa del contenido del evento se puede reproducir incluso si la duración de la vista previa del elemento ENTRY activo expira antes del final del evento.

Ejemplos

En este ejemplo, cuando Reproductor multimedia de Windows recibe el comando de script EVENT y la cadena de comando "Adlink" en el medio de streaming que está representando, busca en la lista de reproducción un EVENTNAME "Adlink". Reproductor multimedia de Windows cambia de la secuencia que está representando y reproduce el contenido al que se hace referencia en event, "https://example.microsoft.com/adlink.htm".

EL ATRIBUTO ENTRYCLIENTSKIP se establece en NO para evitar que se omita el clip DE EVENTOS . Debe jugarse.

El script WHENDONE="RESUME" indica a Reproductor multimedia de Windows reanudar la reproducción del medio anterior desde el que cambió tan pronto como haya finalizado Adlink.asf.

<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>

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior

Consulte también

Referencia de elementos de metarchivo de Windows Media

Referencia de metarchivo de Windows Media

modelo de objetos de Reproductor multimedia de Windows