PARAM 요소

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

PARAM 요소는 재생 목록 또는 재생 목록의 요소와 연결된 사용자 지정 매개 변수를 정의합니다.

<PARAM
   NAME = "parameter name"
   VALUE = "parameter value"
/>

매개 변수

매개 변수는 ASX 태그 바로 다음에 이 요소를 배치하여 개별 클립이 아닌 쇼와 연결할 수도 있습니다. 이러한 항목은 이름 및 인덱스 값이 0으로 시작하는 것으로 참조됩니다.

참고

ASX 요소는 Windows 미디어 플레이어 버전 6.01 이상에서만 사용할 수 있습니다. Microsoft Internet Explorer 5의 표준 설치에는 호환되는 버전의 Windows 미디어 플레이어 포함되어 있습니다.

특성

이름

매개 변수 값에 액세스하는 데 사용되는 이름입니다. 이름은 유효한 문자열일 수 있습니다. 다음 문자열이 이미 정의되어 있습니다.

String 설명
AllowShuffle VALUE 특성은 메타파일 재생 목록에서 Windows 미디어 플레이어 순서 섞기 기능이 임의 순서로 항목을 재생할 수 있는지 여부를 지정합니다. VALUE 특성은 "예" 또는 "아니요"로 설정할 수 있습니다. 기본값은 "아니요"입니다.
CanPause VALUE 특성은 사용자가 재생을 일시 중지할 수 있는지 여부를 지정합니다. VALUE 특성은 "예" 또는 "아니요"로 설정할 수 있습니다. 기본값은 "예"입니다.
CanSeek VALUE 특성은 사용자가 검색 표시줄, 빠른 앞으로 또는 빠른 역방향을 사용하여 현재 재생 위치를 변경할 수 있는지 여부를 지정합니다. VALUE 특성은 "예" 또는 "아니요"로 설정할 수 있습니다. 기본값은 "예"입니다.
CanSkipBack VALUE 특성은 사용자가 이전을 클릭하여 이전 재생 목록 항목으로 뒤로 건너뛸 수 있는지 여부를 지정합니다. VALUE 특성은 "예" 또는 "아니요"로 설정할 수 있습니다. 기본값은 "예"입니다.
CanSkipForward VALUE 특성은 사용자가 다음을 클릭하여 다음 재생 목록 항목으로 건너뛸 수 있는지 여부를 지정합니다. VALUE 특성은 "예" 또는 "아니요"로 설정할 수 있습니다. 기본값은 "예"입니다.
CPRadioID VALUE 특성은 형식 1 온라인 저장소에서 제공하는 라디오 피드의 ID를 지정합니다. 즉, VALUE 특성은 온라인 스토어 카탈로그에 있는 라디오 피드 중 하나의 RadioID 필드와 같아야 합니다. 부모 요소는 ASX 요소입니다.
Encoding VALUE 특성은 메타파일이 유니코드(UTF-8) 인코딩된 파일임을 나타내기 위해 "utf-8"로 설정됩니다.
HtmlFlink VALUE 특성은 형식 1 온라인 저장소에서 제공하는 문자열입니다. Windows 미디어 플레이어 온라인 스토어의 플러그 인에 의해 구현되는 IWMPContentPartner::GetItemInfo 메서드에 문자열을 전달합니다. GetItemInfo 메서드는 플레이어의 지금 재생 창에 표시할 웹 페이지의 URL을 반환합니다. 웹 페이지에서는 External 개체가 형식 1 저장소에 노출하는 모든 메서드에 액세스할 수 있습니다. 이러한 메서드 목록은 Type 1 Online Store의 외부 개체를 참조하세요.
HTMLView VALUE 특성은 부모 요소가 ASX 요소인지 ENTRY 요소인지에 따라 재생 목록 또는 현재 항목의 기간 동안 전체 모드 Player의 지금 재생 창에 표시되는 URL을 지정합니다. HTMLView는 Windows 미디어 플레이어 컨트롤에 대해 지원되지 않습니다.
Log:FieldName[:NameSpace] VALUE 특성은 표시된 로그 필드가 설정될 값을 지정합니다. NAME 특성의 :NameSpace 부분은 선택 사항입니다.
프리 버퍼 VALUE 특성은 다음 재생 목록 항목이 현재 항목이 끝나기 전에 버퍼링을 시작할지 여부를 지정하여 원활한 전환을 가능하게 합니다. VALUE 특성은 "true" 또는 "false"로 설정할 수 있습니다.
ShowWhileBuffering VALUE 특성은 현재 ENTRY 요소에서 참조하는 이미지 파일이 다음 재생 목록 항목이 버퍼링되는 동안 지정된 기간 동안 계속 표시되는지 여부를 지정합니다. VALUE 특성은 "true" 또는 "false"로 설정할 수 있습니다.

VALUE

이 매개 변수와 연결된 값입니다. 숫자 또는 문자열 값일 수 있습니다.

부모/자식 요소

계층 요소
부모 요소 ASX, ENTRY
자식 요소 없음

설명

이 요소를 사용하면 사용자가 각 클립을 포함하는 ENTRY 요소 내에 각 클립에 대한 추가 정보를 배치할 수 있습니다. 재생 목록 ENTRY에 지정된 메타데이터 정보를 검색하려면 미디어를 사용합니다. getItemInfo 메서드. 미디어. getItemInfo 메서드는 매개 변수의 이름을 지정하여 VALUE 특성의 값을 검색합니다. 이전 버전의 Windows 미디어 플레이어 매개 변수 이름과 항목의 인덱스 번호가 지정된 GetMediaParameter 메서드를 사용하여 재생 목록 ENTRY에 지정된 메타데이터 정보를 검색합니다.

매개 변수는 ASX 태그 바로 다음에 이 요소를 배치하여 개별 클립이 아닌 쇼와 연결할 수도 있습니다. 이러한 항목은 이름 및 인덱스 값이 0으로 시작하는 것으로 참조됩니다.

참고

ASX 요소는 Windows 미디어 플레이어 버전 6.01 이상에서만 사용할 수 있습니다. Microsoft Internet Explorer 5의 표준 설치에는 호환되는 버전의 Windows 미디어 플레이어 포함되어 있습니다.

예제

<ASX VERSION="3.0">
   <TITLE>Example Media Player Show</TITLE>
   <PARAM NAME="Director" VALUE="Jane D." />
   
   <ENTRY>
      <TITLE>Example Clip</TITLE>
      <REF HREF="https://sample.microsoft.com/media.asf" />
      <PARAM NAME="Location" VALUE="North America" />
      <PARAM NAME="Release Date" VALUE="March 1998" />
   </ENTRY>
   
   <ENTRY>
      <TITLE>Another Clip</TITLE>
      <REF HREF="https://sample.microsoft.com/more_media.asf" />
      <PARAM NAME="Location" VALUE="Japan">
      <PARAM NAME="Release Date" VALUE="December 1996" />
   </ENTRY>
</ASX>

요구 사항

요구 사항
버전
Windows 미디어 플레이어 버전 7.0 이상에서는 미리 정의된 NAME 특성에 Windows 미디어 플레이어 9 시리즈 이상이 필요합니다. Windows 미디어 플레이어 10 이상은 미리 정의된 이름 CanPause, CanSeek, CanSkipBack 및 CanSkipForward에 필요합니다.

추가 정보

Windows 미디어 플레이어 웹 페이지 표시

스트림 데이터 로깅

Windows Media 메타파일 요소 참조

Windows Media 메타파일 참조