External.changeViewOnlineList 메서드

  • 아티클

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

참고

이 항목에서는 온라인 스토어에서 사용하도록 설계된 기능에 대해 설명합니다. 온라인 스토어의 컨텍스트 외부에서는 이 기능을 사용할 수 없습니다.

changeViewOnlineList 메서드는 Windows 미디어 플레이어 보기를 변경하여 온라인 스토어에서 동적으로 생성된 목록을 표시합니다.

구문

External.changeViewOnlineList(
  LibraryLocationType,
  LibraryLocationID,
  Params,
  FriendlyName,
  ListType,
  ViewMode
)

매개 변수

LibraryLocationType [in]

새 뷰의 형식을 지정하는 라이브러리 위치 상수 입니다. 예를 들어 상수 CPGenreID는 새 보기에 특정 장르가 표시되도록 지정합니다.

LibraryLocationID [in]

새 보기에 표시할 특정 항목의 ID를 포함하는 문자열입니다. 예를 들어 LibraryLocationType 이 CPGenreID인 경우 이 매개 변수는 새 보기에 표시할 장르의 ID를 지정합니다. 이 문자열은 비어 있을 수 있습니다.

Params [in]

IWMPContentPartner::GetTemplate을 호출하여 Windows 미디어 플레이어 온라인 스토어의 플러그 인에 전달하는 매개 변수를 포함하는 문자열입니다. 이러한 매개 변수는 Windows 미디어 플레이어 해석되지 않습니다. 온라인 스토어에서 만들어지고 온라인 스토어에만 의미가 있습니다. 이 문자열은 비어 있을 수 있습니다.

FriendlyName [in]

동적 목록에 대해 Windows 미디어 플레이어 표시할 이름을 포함하는 문자열입니다.

ListType [in]

동적으로 생성된 목록에 있는 항목의 형식을 지정하는 라이브러리 위치 상수입니다. 예를 들어 이 매개 변수의 값이 CPTrackID이면 동적 목록에 트랙이 포함됩니다.

ViewMode [in]

Windows 미디어 플레이어 동적 목록을 표시하는 데 사용할 모드를 지정하는 문자열입니다. 호출자는 이 매개 변수를 contentpartner.h에 정의된 다음 값 중 하나로 설정해야 합니다.

ViewModeReport

ViewModeDetails

ViewModeIcon

ViewModeTile

ViewModeOrderedList

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

검색 페이지의 스크립트가 changeViewOnlineList를 호출하면 Windows 미디어 플레이어 온라인 스토어의 플러그 인에서 구현되는 IWMPContentPartner::GetListContents 및 IWMPContentPartner::GetTemplate 메서드에 따라 일부 매개 변수를 전달합니다. 다음 표에서는 세 가지 메서드의 매개 변수 간의 대응을 보여 줍니다.

changeViewOnlineList 매개 변수 GetListContents 매개 변수 GetTemplate 매개 변수
LocationType location location
LocationID pContext pContext
Params bstrParams bstrViewParams
ListType bstrListType 적용할 수 없음

앞의 표에 표시된 세 가지 메서드는 모두 온라인 스토어에서 구현되므로 매개 변수를 사용하는 방법에 약간의 유연성이 있습니다. GetListContents가 검색해야 하는 목록을 결정하고 GetTemplate이 다음에 표시할 검색 페이지를 결정하기에 충분한 정보를 제공한다는 것입니다. 다음 예제에서는 두 가지 가능성을 보여 줍니다.

예제 1: 온라인 스토어 카탈로그에 있는 동적 목록

플러그 인이 온라인 스토어 카탈로그에 ID가 6인 동적 목록의 콘텐츠를 가져오려고 하는 경우를 가정해 보겠습니다. 목록 6이 트랙 목록이라고 가정합니다. 다음 호출을 수행하여 플러그 인에 충분한 정보를 제공할 수 있습니다.

external.changeViewOnlineList(
   "CPListID", 6, "", 
   "Songs for Today", "CPTrackID", "ViewModeDetails");

Params 매개 변수는 비어 있습니다. 플러그 인에는 다른 매개 변수에 충분한 정보가 있습니다.

예제 2: 온라인 스토어 카탈로그에 없는 동적 목록

플러그 인이 온라인 스토어 카탈로그에 없는 동적 목록의 콘텐츠를 가져오기를 원한다고 가정합니다. 아마도 특정 아티스트가 선택한 노래를 포함하는 동적 목록을 갖기로 결정했을 것입니다. 아티스트가 온라인 스토어 카탈로그에 2의 ID를 가지고 있다고 가정합니다. 다음을 호출할 수 있습니다.

external.changeViewOnlineList(
   "CPArtistID", 2, "songs picked by Sally", 
   "Sally Picks", "CPTrackID", "ViewModeDetails");

LocationType 및 LocationID 매개 변수는 목록을 지정하지 않습니다. 대신 Params 매개 변수는 목록을 지정합니다. LocationType 및 LocationID 매개 변수는 IWMPContentPartner::GetListContents에 전달되지만 이 경우 GetListContents에서 무시할 수 있습니다. LocationType 및 LocationID 매개 변수는 IWMPContentPartner::GetTemplate에도 전달되며, 이를 사용하여 동적 목록과 함께 표시해야 하는 검색 페이지를 결정할 수 있습니다.

요구 사항

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

추가 정보

유형 1 온라인 저장소에 대한 외부 개체

IWMPContentPartner::GetListContents

IWMPContentPartnerCallback::AddListContents

IWMPContentPartner::GetTemplate

위치 및 선택한 항목