管理媒体项

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

Media 对象表示一个媒体项。 它具有属性和方法，可用于检索信息并将其显示给用户，或根据检索的值执行不同的操作。

使用 Media 对象的大部分工作都涉及有关媒体项内容的元数据，称为 属性。 主题 媒体项属性 介绍如何读取和更改属性值。 除了本主题之外，请参阅 Microsoft 网站上的 Windows Media 元数据使用指南 ，了解有关属性及其用法的详细信息。

Media 对象具有直接检索某些属性的属性和方法，例如项的名称或持续时间。 对于视频项，可以检索图像的高度和宽度，也可以根据标记的名称或索引检索标记信息。 还可以确定特定媒体项是否包含在特定的播放列表中。

检索媒体对象

可以使用 Player 快速访问当前媒体项。currentMedia 属性。

在本主题中， Player 对象按以下方式定义：

AxWMPLib.AxWindowsMediaPlayer Player;
using WMPLib;

以下 C# 示例检索表示当前项的 Media 对象。

IWMPMedia media;
media = Player.currentMedia;

可以使用 Player 从数字媒体文件创建新的媒体项。newMedia 方法。 向 方法传递数字媒体文件的 URL 路径，并返回对新 Media 对象的引用。 方法不会将新对象直接添加到库。 但是，可以将 对象传递给 播放列表。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

使用库