AxWindowsMediaPlayer 개체의 ScriptCommand 이벤트

  • 아티클

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

ScriptCommand 이벤트는 동기화된 명령 또는 URL이 수신될 때 발생합니다.

[C#]
private void player_ScriptCommand(
  object sender,
  _WMPOCXEvents_ScriptCommandEvent e
)

[Visual Basic]
Private Sub player_ScriptCommand(  
  sender As Object, 
  e As _WMPOCXEvents_ScriptCommandEvent
) Handles player.ScriptCommand

이벤트 데이터

이 이벤트와 연결된 처리기는 AxWMPLib._WMPOCXEvents_ScriptCommandEventHandler 형식입니다. 이 처리기는 이 이벤트와 관련된 다음 속성을 포함하는 AxWMPLib._WMPOCXEvents_ScriptCommandEvent 형식의 인수를 받습니다.

속성 설명
scType System.StringS는 스크립트 명령의 형식을 지정합니다.
매개변수(param) System.StringS는 스크립트 명령을 지정합니다.

설명

명령은 Windows Media 파일 또는 스트림의 소리와 이미지에 포함될 수 있습니다. 명령은 스트림에서 지정된 시간과 연결된 유니코드 문자열 쌍입니다. 스트림이 명령과 연결된 시간에 도달하면 Windows 미디어 플레이어 컨트롤은 두 개의 매개 변수를 사용하여 ScriptCommand 이벤트를 보냅니다. 한 매개 변수는 전송되는 명령의 형식을 지정하고 다른 매개 변수는 명령을 지정합니다. 매개 변수의 형식은 명령 매개 변수가 처리되는 방법을 결정하는 데 사용됩니다. ScriptCommand 이벤트에서 처리할 파일 또는 스트림에 모든 유형의 명령을 포함할 수 있습니다.

다음 표에는 Windows 미디어 플레이어 자동으로 처리되는 스크립트 명령 유형이 나열되어 있습니다.

형식 설명
CAPTION 컨트롤은 IWMPClosedCaption으로 지정된 HTML 요소에 연결된 텍스트를 표시합니다. captioningId.
이벤트 컨트롤은 지정된 이벤트에 대해 정의된 지침을 실행합니다.
파일 컨트롤은 해당 URL 속성을 재설정하고, 지정된 파일을 열려고 시도하고, 새 스트림을 즉시 재생하기 시작합니다.
OPENEVENT EVENT 스크립트를 적시에 실행하기 위해 연결된 EVENT 형식 명령을 버퍼링합니다.
SYNCHRONIZEDLYRICLYRIC param 매개 변수에는 동기화된 가사 텍스트가 포함됩니다. Windows 미디어 플레이어 지금 재생 기능의 닫힌 캡션 영역에 가사 텍스트를 표시합니다.
TEXT 컨트롤은 IWMPClosedCaption으로 지정된 HTML 요소에 연결된 텍스트를 표시합니다. captioningId.
URL 컨트롤은 IWMPSettings인 경우 기본 인터넷 브라우저를 사용하여 지정된 URL을 자동으로 엽니다. invokeURLs 속성은 true로 설정됩니다.

명령을 처리하는 코드를 제공하는 한 다른 유형의 명령을 포함할 수 있습니다. 알 수 없는 명령은 Windows 미디어 플레이어 컨트롤에서 무시되지만 여전히 ScriptCommand 이벤트에 전달됩니다.

파일이 빠른 전달 또는 되윈드 모드에서 검사되는 경우 ScriptCommand 이벤트가 호출되지 않습니다.

Windows 미디어 플레이어 컨트롤에서 받은 URL 명령은 IWMPSettings인 경우 기본 웹 브라우저에서 자동으로 호출됩니다.invokeURLs 속성은 true로 설정됩니다. IWMPSettings를 사용할 수 있습니다. defaultFrame 속성 - 웹 페이지가 표시되는 대상 프레임을 지정합니다.

Windows 미디어 플레이어 전송된 URL은 IWMPSettings에서 지정한 기본 URL을 기준으로 처리됩니다.baseURL 속성입니다. 기본 URL은 상대 URL과 연결되므로 ScriptCommand 이벤트에 의해 명령 매개 변수로 전달되는 완전히 지정된 URL이 생성됩니다.

Windows 미디어 플레이어 컨트롤은 항상 다음과 같은 방식으로 들어오는 URL 명령을 처리합니다.

  1. URL 형식 명령이 수신됩니다.
  2. IWMPSettings. baseURL 은 스크립트 명령에 지정된 상대 URL에서 전체 URL을 만드는 데 사용됩니다.
  3. ScriptCommand 가 호출됩니다.
  4. ScriptCommand가 반환되면 IWMPSettings가 반환됩니다. invokeURL이 선택되어 있습니다.
  5. IWMPSettings인 경우. invokeURL 은 true이고 명령은 URL 명령이며 지정된 URL이 호출됩니다. IWMPSettings인 경우. invokeURL 은 false이거나 명령이 URL 명령이 아니면 명령이 무시됩니다.

Windows Media 파일을 작성할 때 두 개의 앰퍼샌드와 매개 변수 필드의 프레임 이름을 연결하여 새 URL이 표시되는 프레임을 지정할 수 있습니다. 다음 예제에서는 일반적인 ScriptCommand 매개 변수를 보여 줍니다. myframe 프레임에서 URL mypage를 실행해야 하며,

scType = "URL"
Param = https://myweb/mypage.html&&myframe

파일을 검사하는 경우 ScriptCommand 이벤트가 호출되지 않습니다(빨리 전달되거나 다시 풀기).

요구 사항

요구 사항 값
버전
 Windows 미디어 플레이어 9 시리즈 이상
네임스페이스
 AxWMPLib
어셈블리
AxInterop.WMPLib.dll(AxInterop.WMPLib.dll.dll)

추가 정보

AxWindowsMediaPlayer 개체(VB 및 C#)

AxWindowsMediaPlayer.URL(VB 및 C#)

IWMPClosedCaption.captioningId(VB 및 C#)

IWMPSettings.baseURL(VB 및 C#)

IWMPSettings.defaultFrame(VB 및 C#)

IWMPSettings.invokeURLs(VB 및 C#)