Элемент EVENT

[Функция, связанная с этой страницей, Медиаплеер Windows SDK, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Элемент EVENT определяет поведение или действие, выполняемое Медиаплеер Windows при получении команды скрипта, помеченной как событие.

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

Атрибуты

NAME (обязательно)

Имя события.

WHENDONE (обязательно)

Значение , определяющее, что Медиаплеер Windows выполняет после воспроизведения указанного содержимого.

Возможны следующие значения.

Значение	Описание
RESUME	Текущая запись (клип, прерванный событием) возобновляет воспроизведение. Если содержимое хранится, оно возобновляется в том же месте, где оно было остановлено; Если содержимое является широковещательным, оно возобновляется в текущей позиции.
NEXT	Следующий элемент ENTRY воспроизводится так, как если бы событие не произошло и Медиаплеер Windows достигла конца текущего клипа.
BREAK	Если текущая запись находится в цикле REPEAT , цикл завершается так, как если бы счетчик повторов был завершен. В противном случае Медиаплеер Windows переходит в конец списка воспроизведения, как если бы последняя запись была завершена как обычно.

Родительские и дочерние элементы

Иерархия	Элементы
Родительские элементы	ASX
Дочерние элементы	ENTRY, ENTRYREF

Комментарии

Этот элемент определяет поведение или действие, выполняемое Медиаплеер Windows при получении команды скрипта, помеченной как событие. Событие — это определенный тип команды скрипта, внедренный в поток, отправляемый в Медиаплеер Windows, состоящий из двойной строки. Первая строка — это слово "event", а вторая строка — имя события. Имя события во второй строке должно соответствовать имени события, определенному в метафайле. (Совпадение не учитывает регистр.) События можно отправлять в Медиаплеер Windows получения потока в режиме реального времени или сохраняться в ASF-, WMA- или WMV-файле, который доставляется в виде одноадресного потока по запросу. Когда Медиаплеер Windows получает команду скрипта, он обрабатывает событие в соответствии с определением элемента EVENT.

Этот элемент определяет область элементов ENTRY или ENTRYREF, которые обрабатываются всякий раз, когда Медиаплеер Windows получает команду скрипта с именованным событием. ENTRYREF может быть URL-адресом, указывающим на asp-страницу. С помощью этого элемента можно указать поведение для переключения потоков практически в реальном времени, в отличие от предварительно созданных изменений потока с помощью ссылок на другие фрагменты содержимого или метафайлы Windows Media.

При использовании asp-страниц для создания списков воспроизведения необходимо указать значение для ответа. Свойство ContentType и response. Свойство expires на asp-странице из-за проблем с задержкой Медиаплеер Windows. Ответ. ContentType должен быть допустимым расширением имени файла для метафайлов Windows Media. Допустимые типы: .asf, .asx, .wma, .wax, .wmv и .wvx.

Дополнительные сведения об использовании объекта Response в ASP см. в пакете SDK для платформы.

Этот элемент может отображаться в любом месте элемента ASX . Если несколько элементов EVENT в элементе ASX имеют одинаковые значения для атрибутов NAME, Медиаплеер Windows использует первое вхождение в элементе ASX и игнорирует все остальные. Если элементы EVENT имеют различные атрибуты NAME , их порядок в элементе ASX не имеет значения.

Медиаплеер Windows отменяет события, получаемые при обработке другого события. Вложение событий не поддерживается. Если Медиаплеер Windows находится в режиме предварительного просмотра, содержимое события не ограничивается элементом PREVIEWDURATION; полная длина содержимого события может воспроизводиться, даже если срок действия предварительного просмотра активного элемента ENTRY истекает до окончания события.

Примеры

В этом примере, когда Медиаплеер Windows получает команду скрипта EVENT и командную строку "Adlink" на отрисовке потокового мультимедиа, он выполняет поиск в списке воспроизведения по запросу EVENTNAME "Adlink". Медиаплеер Windows переключается из потока, который он отрисовывается, и воспроизводит содержимое, на которое ссылается event, "https://example.microsoft.com/adlink.htm".

Атрибут ENTRYCLIENTSKIP имеет значение НЕТ, чтобы предотвратить пропуск клипа СОБЫТИЯ . Это должно быть сыграно.

Сценарий WHENDONE="RESUME" предписывает Медиаплеер Windows возобновить воспроизведение предыдущего носителя, с который он переключился, после завершения 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>

Требования

Требование	Значение
Версия	Медиаплеер Windows версии 7.0 или более поздней

См. также раздел

Справочник по элементам метафайлов Windows Media

Справочник по метафайлам Windows Media

Объектная модель Медиаплеер Windows