Elemento EVENT

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O elemento EVENT define um comportamento ou uma ação executada por Reprodutor Multimídia do Windows quando recebe um comando de script rotulado como um evento.

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

Atributos

NAME (obrigatório)

O nome do evento.

WHENDONE (obrigatório)

Um valor que define o que Reprodutor Multimídia do Windows faz depois de reproduzir o conteúdo referenciado.

Os valores a seguir são possíveis.

Valor	Descrição
RESUME	A entrada atual (o clipe interrompido pelo evento) continua sendo reproduzida. Se o conteúdo for armazenado, ele será retomado no mesmo ponto em que parou; se o conteúdo for difundido, ele será retomado na posição atual.
NEXT	O próximo elemento ENTRY é reproduzido como se o evento não tivesse ocorrido e Reprodutor Multimídia do Windows tivesse chegado ao final do clipe atual.
BREAK	Se a entrada atual estiver dentro de um loop REPEAT , o loop terminará como se a contagem de repetição tivesse sido concluída. Caso contrário, Reprodutor Multimídia do Windows salta para o final da playlist como se a entrada final tivesse sido concluída como de costume.

Elementos pai/filho

Hierarquia	Elementos
Elementos pai	ASX
Elementos filho	ENTRY, ENTRYREF

Comentários

Esse elemento define um comportamento ou uma ação executada por Reprodutor Multimídia do Windows quando recebe um comando de script rotulado como um evento. Um evento é um tipo específico de comando de script inserido em um fluxo enviado para Reprodutor Multimídia do Windows que consiste em uma cadeia de caracteres dupla. A primeira cadeia de caracteres é a palavra "event" e a segunda cadeia de caracteres é o nome do evento. O nome do evento na segunda cadeia de caracteres deve corresponder ao nome do evento definido no metarquivo. (A correspondência não diferencia maiúsculas de minúsculas.) Os eventos podem ser enviados para Reprodutor Multimídia do Windows receber um fluxo em tempo real ou podem ser salvos em um arquivo .asf, .wma ou .wmv que é entregue como um fluxo unicast sob demanda. Quando Reprodutor Multimídia do Windows recebe o comando de script, ele processa o evento conforme definido pelo elemento EVENT.

Esse elemento define um escopo de elementos ENTRY ou ENTRYREF que são processados sempre que Reprodutor Multimídia do Windows recebe o comando script com o evento nomeado. ENTRYREF pode ser uma URL que aponta para uma página ASP. Com esse elemento, você pode especificar um comportamento para a alternância de fluxo quase em tempo real, em vez de alterações de fluxo pré-criadas usando referências a outras partes de conteúdo ou metarquivos do Windows Media.

Ao usar páginas ASP para gerar playlists, você deve especificar um valor para a Resposta. Propriedade ContentTypee Response.expira a propriedade na página ASP devido a problemas de latência com Reprodutor Multimídia do Windows. A resposta. ContentType deve ser uma extensão de nome de arquivo válida para metarquivos do Windows Media. Os tipos válidos incluem .asf, .asx, .wma, .wax, .wmv e .wvx.

Consulte o SDK da Plataforma para obter detalhes sobre como usar o objeto Response no ASP.

Esse elemento pode aparecer em qualquer lugar dentro do elemento ASX . Se vários elementos EVENT em um elemento ASX tiverem valores idênticos para seus atributos NAME, Reprodutor Multimídia do Windows usará a primeira ocorrência dentro do elemento ASX e ignorará todos os outros. Quando os elementos EVENT têm atributos NAME distintos, sua ordem dentro do elemento ASX não importa.

Reprodutor Multimídia do Windows descarta eventos que recebe durante o processamento de outro evento. Não há suporte para aninhamento de eventos. Quando Reprodutor Multimídia do Windows está no modo de visualização, o conteúdo do evento não é restrito pelo elemento PREVIEWDURATION; o comprimento completo do conteúdo do evento pode ser reproduzido mesmo se a duração da visualização do elemento ENTRY ativo expirar antes do final do evento.

Exemplos

Neste exemplo, quando Reprodutor Multimídia do Windows recebe o comando de script EVENT e a cadeia de caracteres de comando "Adlink" na mídia de streaming que está renderizando, ele pesquisa na playlist um EVENTNAME "Adlink". Reprodutor Multimídia do Windows alterna do fluxo que está renderizando e reproduz o conteúdo referenciado no EVENTO, "https://example.microsoft.com/adlink.htm".

O atributo ENTRY CLIENTSKIP é definido como NÃO para impedir que o clipe event seja ignorado. Deve ser jogado.

O script WHENDONE="RESUME" instrui Reprodutor Multimídia do Windows a retomar a reprodução da mídia anterior da qual alternou assim que Adlink.asf for concluído.

<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	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior

Confira também

Referência de elementos de metarquivo do Windows Media

Referência de metarquivo do Windows Media

modelo de objeto Reprodutor Multimídia do Windows