管理媒體專案

  • 發行項

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

Media物件代表一個媒體專案。 它具有屬性和方法，可用來擷取資訊並向使用者顯示，或根據您擷取的值採取不同的動作。

大部分的 媒體 物件都牽涉到有關媒體專案內容的中繼資料，稱為 屬性。 媒體專案屬性主題說明如何讀取和變更屬性值。 除了本主題之外，請參閱 Microsoft 網站上的 Windows 媒體中繼資料使用方針 ，以取得屬性及其使用方式的詳細資訊。

Media物件具有直接擷取某些屬性的屬性和方法，例如專案的名稱或持續時間。 對於視訊專案，您可以擷取影像的高度和寬度，而且可以根據標記的名稱或索引來擷取標記資訊。 您也可以判斷特定媒體專案是否包含在特定的播放清單中。

擷取媒體物件

您可以使用 Player快速存取目前的媒體專案。currentMedia 屬性。

在本主題中， Player 物件是以下列方式定義：

AxWMPLib.AxWindowsMediaPlayer Player;
using WMPLib;

下列 C# 範例會擷取代表目前專案的 Media 物件。

IWMPMedia media;
media = Player.currentMedia;

您可以使用 Player，從數位媒體檔案建立新的媒體專案。newMedia 方法。 您會將 URL 路徑傳遞給數位媒體檔案的方法，並傳回新 Media 物件的參考。 方法不會直接將新物件新增至程式庫。 不過，您可以將 物件傳遞至 Playlist。appendItem 方法或 播放清單。insertItem 方法。

下列 C# 範例會根據隨 Windows 媒體播放機 SDK 一起安裝的其中一個數位媒體範例，建立Media物件。

IWMPMedia media;
media = Player.newMedia("C:\\WMSDK\\WMPSDK10\\samples\\media\\laure.wma");

注意

您必須在字串中包含兩個反斜線 (\) 字元 (或使用 C#) 中的 @ 字元來代表一個實際的反斜線字元。 這是因為 C# 會使用單一反斜線字元來定義逸出序列。

 

您可以從數位媒體檔案建立新的媒體專案，並使用 MediaCollection在一個步驟中將其新增至媒體櫃。add 方法。 就像 玩家一樣。newMedia 方法， add 方法會採用數位媒體檔案的路徑。

下列 C# 範例會根據其中一個 SDK 範例檔案建立 Media 物件，並將該物件新增至程式庫。

IWMPMedia media;
media = Player.mediaCollection.add("C:\\WMSDK\\WMPSDK10\\samples\\media\\laure.wma");

您可以使用播放清單來擷取代表播放清單中媒體專案的Media物件。item方法。 下列 C# 範例會從目前的播放清單擷取第六個媒體專案。

IWMPMedia media;
media = Player.currentPlaylist.get_Item(5);

Controls.currentItem

管理播放清單

媒體物件

MediaCollection.add

Player.currentMedia

Player.newMedia

Playlist.item

使用程式庫