External.changeView 메서드

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

참고

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

changeView 메서드는 Windows 미디어 플레이어 보기를 변경합니다.

구문

External.changeView(
  LibraryLocationType,
  LibraryLocationID,
  Filter,
  ViewParams
)

매개 변수

LibraryLocationType [in]

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

LibraryLocationID [in]

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

필터 [in]

새 보기에 대한 필터를 포함하는 문자열입니다. 사용자가 플레이어의 단어 휠 컨트롤에 이 텍스트를 입력한 것처럼 보기가 필터링됩니다. 이 문자열은 비어 있을 수 있습니다.

ViewParams [in]

Windows 미디어 플레이어 새 보기와 함께 표시되는 새 검색 페이지에서 사용할 수 있는 매개 변수가 포함된 문자열입니다. 이러한 매개 변수는 Windows 미디어 플레이어 해석되지 않습니다. 온라인 스토어에서 만들어지고 온라인 스토어에만 의미가 있습니다.

반환 값

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

설명

경우에 따라 LibraryLocationID 매개 변수를 빈 문자열로 설정하는 것이 좋습니다. 예를 들어 LibraryLocationType 매개 변수를 AllCPAlbumIDs로 설정하면 새 보기가 모든 앨범을 나타냅니다. 새 보기의 포커스가 되는 개별 앨범은 없으므로 LibraryLocationID 매개 변수에 앨범 ID를 제공할 필요가 없습니다.

ViewParams 매개 변수는 검색 페이지가 다른 검색 페이지와 통신하는 방법을 제공합니다. 검색 페이지의 스크립트가 changeView를 호출하면 Windows 미디어 플레이어 사용자 인터페이스를 조정합니다. 이렇게 조정하면 플레이어가 플러그 인의 IWMPContentPartner::GetTemplate 메서드를 호출하여 새 검색 페이지의 URL을 가져옵니다. 원래 검색 페이지에서 ViewParams 매개 변수에 전달하는 문자열은 GetTemplate에 전달되지 않습니다. 그러나 새 검색 페이지는 External.viewParameters를 호출하여 ViewParams 문자열을 검색할 수 있습니다.

요구 사항

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

추가 정보

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

External.changeViewOnlineList

External.libraryLocationID

External.libraryLocationType

External.viewParameters