共用方式為

探索頁面

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

如果作用中的線上商店是類型 1 商店，Windows 媒體播放機在其使用者介面中顯示商店的內容。 程式庫樹狀檢視控制項具有線上商店的節點。 當使用者按一下該節點或任何其子節點時，Windows 媒體播放機會在詳細資料窗格中顯示線上商店的內容。

當使用者在樹狀檢視控制項或詳細資料窗格中與線上商店內容互動時，Windows 媒體播放機顯示線上商店所提供的網頁，稱為探索頁面。 探索頁面可在使用者流覽線上商店目錄時提供音樂的其他資訊。 探索頁面會透過External 物件的屬性、方法和事件，與Windows 媒體播放機通訊。

每當Windows 媒體播放機變更線上商店內容的檢視時，它會呼叫IWMPContentPartner：：GetTemplate，由線上商店外掛程式實作，以取得探索頁面的 URL，以顯示新的檢視。

Windows 媒體播放機中的線上商店內容檢視有五項資訊：工作、位置類型、位置識別碼、選取的專案類型和選取的專案識別碼。 Windows 媒體播放機會將這五個專案提供給task、location、pCoNtext、clickLocation和pClickCoNtext參數中的GetTemplate方法。 Windows 媒體播放機讓這五個專案可供在External物件的工作、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屬性中的下一個探索頁面使用。

關於類型 1 線上商店

位置和選取的專案