다음을 통해 공유

Player.ScriptCommand 이벤트

  • 아티클

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

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

구문

Player.ScriptCommand(
  scType,
  Param
)

매개 변수

scType

스크립트 명령의 형식을 지정하는 문자열입니다.

Param

스크립트 명령을 지정하는 문자열입니다.

반환 값

이 이벤트는 값을 반환하지 않습니다.

설명

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

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

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

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

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

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

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

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

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

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

파일을 검사하는 경우 ScriptCommand 이벤트가 호출되지 않습니다(빨리 전달되거나 빠르게 반전됨).

이벤트 매개 변수의 값은 Windows 미디어 플레이어 지정되며 지정된 매개 변수 이름을 사용하여 가져온 JScript 파일의 메서드에 액세스하거나 전달할 수 있습니다. 이 매개 변수 이름은 대문자를 포함하여 표시된 대로 정확하게 입력해야 합니다.

요구 사항

요구 사항 값
버전
 Windows 미디어 플레이어 버전 7.0 이상.
DLL
Wmp.dll

추가 정보

Player 개체

Player.URL

Settings.baseURL

Settings.defaultFrame

Settings.invokeURLs