程式庫整合

  • 發行項

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

Windows 媒體播放機使用者介面會組織成稱為工作窗格的功能區域，以封裝程式的各種高階功能。 其中包括 [連結 庫]、[ 同步處理] 和 [ Burn] 工作窗格， (其他) 。 [ 程式庫 ] 工作窗格可讓使用者使用程式庫;[ 同步處理 ] 工作窗格可讓使用者將數位媒體檔案同步至可攜式裝置;和 [媒體] 工作窗格可讓使用者將數位媒體檔案轉換成 CD 或 DVD。

注意

連結 庫 工作窗格有時稱為 [流覽 ] 工作窗格。

 

每個工作窗格都有一些與程式庫的整合層級。 例如，如果使用者想要將音樂轉換成 CD，讓使用者藉由流覽媒體櫃來選擇音樂以播放，並直接將媒體專案拖放到清單中即可。 這表示使用者可以在文檔庫、同步處理和Burn工作窗格中工作時，檢視和使用完全整合到文件庫中的線上商店目錄。 WMPTaskType列舉包含代表這三個工作窗格的值，以便以程式設計方式加以識別。

這三個工作窗格的每一個都會組織成三個主要部分。 第一個部分是程式庫樹狀檢視控制項。 此控制項為使用者提供Windows 媒體播放機程式庫的階層式檢視，包括依歌曲、藝術師、相簿等分類功能。 第二個工作窗格部分是詳細資料窗格。 此窗格會根據目前在程式庫樹狀檢視控制項中選取的類別來提供組織的詳細資訊。 例如，如果使用者在樹狀檢視中按一下 [ 歌曲 ]，詳細資料窗格會顯示目前在文件庫中的歌曲標題，以及其他資訊，例如長度和相簿標題。 第三個部分是清單窗格或 購物籃。 使用者可以將媒體專案拖放到購物籃中，以建置清單，例如播放清單、同步清單和錄製清單。

當線上商店目錄與文件庫整合時，線上商店會顯示為文件庫樹狀檢視控制項中的最上層類別或 節點。 (使用者一次只能看到一個線上商店目錄。) 當使用者按一下節點來選擇檢視線上商店目錄時，詳細資料窗格會顯示線上商店目錄中音樂的相關資訊。 這包括使用者已購買或租用的音樂，以及使用者尚未取得的音樂。

最上層線上商店節點有一組由 Windows 媒體播放機 提供的子節點。 例如，最上層線上商店節點具有 Radio、Artist 和 Album 子節點等等。 最上層線上商店節點也可以有最多八個線上商店所提供的自訂子節點。 Windows 媒體播放機為範圍 0 到 7 中具有清單識別碼的任何清單建立自訂子節點。 線上商店會指定 list.csv檔案中 屬於市集目錄一部分的清單識別碼。

Windows 媒體播放機藉由呼叫IWMPContentPartner：：GetItemInfo，在bstrInfoName參數中傳遞 CPListIDIcon，以擷取每個線上商店自訂樹狀節點的圖示。

當使用者流覽目錄時，Windows 媒體播放機呼叫IWMPContentPartner：：GetItemInfo，以從使用者選取的音樂專案內容夥伴外掛程式擷取中繼資料。 此中繼資料會將資訊提供給播放機，讓播放機能夠顯示目錄專案的詳細資料。 例如，如果使用者選取相簿，Windows 媒體播放機擷取相簿藝術師 URL，讓使用者可以看到相簿封面藝術師。

關於類型 1 線上商店