Share via


Windows Media Player 11 SDK Discovery PagesĀ 

Windows Media Player SDK banner art

Previous Next

Discovery Pages

When the user views the online store catalog by clicking it in the library tree-view control, the Browse feature includes a special Web page, called the discovery page. The discovery page is supplied by the online store to display additional information about the music as the user browses the catalog.

Windows Media Player retrieves the URL for the discovery page by calling IWMPContentPartner::GetTemplate. The Player provides details about the current location displayed in its user interface so that the online store can display different Web pages in different situations. For example, the discovery page that the online store displays if the user is viewing content in the Rock genre might be different from the discovery page displayed if the user is viewing content in the Jazz genre.

A Web page that is hosted as a discovery page in Windows Media Player has access to a special object, called the External object. The External object provides a variety of properties, methods, and events. For example, the method named External.changeView enables the Web page to use script code to navigate the Windows Media Player user interface to a particular location. The External.OnViewChange event occurs when the current view changes, such as when the user navigates through the user interface (or when changeView is called).

The External object also provides methods and events that enable communication between the discovery page and the content partner plug-in. When this happens, Windows Media Player acts as the bridge between the discovery page and the plug-in object. For example, the discovery page can call External.sendMessage to send a custom message to the plug-in. Windows Media Player receives this method call and in turn calls IWMPContentPartner::SendMessage to pass the message to the plug-in. When the plug-in has finished processing the message, it calls IWMPContentPartnerCallback::SendMessageComplete. Windows Media Player then passes this event to the discovery page by raising the External.OnSendMessageComplete event in the Web page.

See Also

Previous Next