검색 페이지
[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
활성 온라인 저장소가 형식 1 저장소인 경우 Windows 미디어 플레이어 사용자 인터페이스에 저장소의 콘텐츠를 표시합니다. 라이브러리 트리 뷰 컨트롤에는 온라인 저장소에 대한 노드가 있습니다. 사용자가 해당 노드 또는 해당 하위 노드를 클릭하면 Windows 미디어 플레이어 세부 정보 창에 온라인 저장소의 콘텐츠를 표시합니다.
사용자가 트리 뷰 컨트롤 또는 세부 정보 창에서 온라인 스토어 콘텐츠와 상호 작용할 때 Windows 미디어 플레이어 온라인 스토어에서 제공하는 검색 페이지라는 웹 페이지를 표시합니다. 검색 페이지는 사용자가 온라인 스토어의 카탈로그를 검색할 때 음악에 대한 추가 정보를 제공합니다. 검색 페이지는 외부 개체의 속성, 메서드 및 이벤트를 통해 Windows 미디어 플레이어 통신합니다.
Windows 미디어 플레이어 온라인 스토어 콘텐츠의 보기를 변경할 때마다 온라인 스토어의 플러그 인에 의해 구현된 IWMPContentPartner::GetTemplate을 호출하여 새 보기와 함께 표시할 검색 페이지의 URL을 가져옵니다.
Windows 미디어 플레이어 온라인 스토어 콘텐츠 보기에는 작업, 위치 유형, 위치 ID, 선택한 항목 유형 및 선택한 항목 ID의 다섯 가지 정보가 특징입니다. Windows 미디어 플레이어 이러한 5개 항목을 작업, 위치, pContext, clickLocation 및 pClickContext 매개 변수의 GetTemplate 메서드에 제공합니다. Windows 미디어 플레이어 이러한 5개 항목을 작업, libraryLocationType, libraryLocationID, selectedItemType 및 selectedItemID 속성의 검색 페이지에 사용할 수 있도록 합니다. Windows 미디어 플레이어 온라인 스토어 콘텐츠의 보기를 지정하는 방법에 대한 자세한 내용은 위치 및 선택한 항목을 참조하세요.
검색 페이지가 Windows 미디어 플레이어 통신할 수 있도록 하는 것 외에도 외부 개체를 사용하면 검색 페이지가 온라인 스토어의 플러그 인과 통신할 수 있습니다. 이 경우 Windows 미디어 플레이어 검색 페이지와 플러그 인 간의 브리지 역할을 합니다. 예를 들어 검색 페이지에서 External.sendMessage 를 호출하여 플러그 인에 사용자 지정 메시지를 보낼 수 있습니다. Windows 미디어 플레이어 이 메서드 호출을 수신하고 IWMPContentPartner::SendMessage를 호출하여 플러그 인에 메시지를 전달합니다. 플러그 인이 메시지 처리를 완료하면 IWMPContentPartnerCallback::SendMessageComplete를 호출합니다. 그런 다음, Windows 미디어 플레이어 External.OnSendMessageComplete 이벤트를 발생시켜 검색 페이지에 알릴 수 있습니다.
또한 External 개체는 검색 페이지가 다른 검색 페이지와 통신할 수 있는 방법을 제공합니다. 검색 페이지의 스크립트가 External.changeView를 호출하면 스크립트는 ViewParams 매개 변수에 문자열을 제공할 수 있습니다. Windows 미디어 플레이어 ViewParams 문자열을 해석하지 않지만 External.viewParameters 속성의 다음 검색 페이지에서 문자열을 사용할 수 있도록 합니다.
관련 항목
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기