MediaCollection.getByAttribute 方法

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

getByAttribute 方法检索包含指定属性的指定值的媒体项的播放列表。

语法

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

参数

attribute [in]

指示要搜索的属性的名称的字符串。 有关 Windows 媒体播放器 支持的属性的信息，请参阅 Windows 媒体播放器 属性参考。

value [in]

指示 特性应具有的值的字符串。

返回值

此方法返回 一个 Playlist 对象。

备注

此方法可用于为与数据库中属性的值匹配的媒体项创建泛型查询。 这在用户定义属性的情况下很有用。 如果该属性不存在，将导致错误。

可以使用此方法检索特定类型的所有媒体项。 使用属性名称“MediaType”和以下值之一：

值	说明
音频	音乐和其他仅限音频的项目。
播放列表	表示为 Media 对象的播放列表。
radio	无线电台项目。 Windows 媒体播放器 10 不使用。
视频	视频项。
照片	照片项目。 需要 10 Windows 媒体播放器。
其他	其他项，例如 ASF 文件或流式处理媒体的 URL。

若要使用此方法，需要对库的读取访问权限。 有关详细信息，请参阅 库访问。

示例

以下 JScript 示例使用 MediaCollection。getByAttribute 由名为 Triode 48 的艺术家播放库中的所有内容。 创建 ID 为“Player”的 Player 对象。

// Get a playlist object filled with media items by a 
// particular artist.
var pl = Player.mediaCollection.getByAttribute("Artist", "Triode 48");

// Make the new playlist the current one.
Player.currentPlaylist = pl;

// Start Windows Media Player.
Player.controls.play();

要求

要求	值
版本	Windows 媒体播放器版本 7.0 或更高版本。
DLL	Wmp.dll

另请参阅

MediaCollection 对象

Playlist 对象

Settings.mediaAccessRights

Settings.requestMediaAccessRights