Share via

EVENT 요소

  • 아티클

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 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 요소에 정의된 대로 이벤트를 처리합니다.

이 요소는 Windows 미디어 플레이어 명명된 이벤트가 있는 스크립트 명령을 받을 때마다 처리되는 ENTRY 또는 ENTRYREF 요소의 scope 정의합니다. ENTRYREF는 ASP 페이지를 가리키는 URL일 수 있습니다. 이 요소를 사용하면 다른 콘텐츠 또는 Windows Media 메타파일에 대한 참조를 사용하여 미리 작성된 스트림 변경 내용과 달리 스트림 전환에 대한 동작을 거의 실시간으로 지정할 수 있습니다.

ASP 페이지를 사용하여 재생 목록을 생성하는 경우 응답에 대한 값을 지정해야 합니다. ContentType 속성 및 Response입니다. 는 Windows 미디어 플레이어 대기 시간 문제로 인해 ASP 페이지의 속성을 만료합니다. 응답입니다. ContentType은 Windows Media 메타파일의 유효한 파일 이름 확장명이어야 합니다. 유효한 형식에는 .asf, .asx, .wma, .wax, .wmv 및 .wvx가 포함됩니다.

ASP에서 Response 개체를 사용하는 방법에 대한 자세한 내용은 Platform SDK를 참조하세요.

이 요소는 ASX 요소 내의 아무 곳에나 나타날 수 있습니다. ASX 요소 내의 여러 EVENT 요소에 NAME 특성에 대해 동일한 값이 있는 경우 Windows 미디어 플레이어 ASX 요소 내에서 첫 번째 항목을 사용하고 다른 모든 요소를 무시합니다. EVENT 요소에 고유한 NAME 특성이 있는 경우 ASX 요소 내의 순서는 중요하지 않습니다.

Windows 미디어 플레이어 다른 이벤트를 처리하는 동안 수신하는 이벤트를 삭제합니다. 이벤트 중첩은 지원되지 않습니다. Windows 미디어 플레이어 미리 보기 모드인 경우 이벤트 콘텐츠는 PREVIEWDURATION 요소에 의해 제한되지 않습니다. 활성 ENTRY 요소의 미리 보기 기간이 이벤트가 끝나기 전에 만료되더라도 이벤트 콘텐츠의 전체 길이가 재생될 수 있습니다.

예제

이 예제에서는 Windows 미디어 플레이어 렌더링 중인 스트리밍 미디어에서 EVENT 및 명령 문자열 "Adlink"라는 스크립트 명령을 받으면 재생 목록에서 EVENTNAME "Adlink"를 검색합니다. Windows 미디어 플레이어 렌더링 중인 스트림에서 전환하고 EVENT에서 참조되는 콘텐츠를 재생합니다. "https://example.microsoft.com/adlink.htm".

ENTRY 특성 CLIENTSKIP 는 이벤트 클립을 건너뛰지 못하도록 NO로 설정됩니다. 그것은 재생해야합니다.

스크립트 WHENDONE="RESUME" 는 Adlink.asf가 완료되는 즉시 전환된 이전 미디어 재생을 다시 시작하도록 Windows 미디어 플레이어 지시합니다.

<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 미디어 플레이어 개체 모델