MediaCollection 对象

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

MediaCollection 对象提供了一种组织大型媒体项集合的方法。 可以查询它以自动生成播放列表。

MediaCollection 对象支持以下方法。

方法	说明
add	将新的媒体项或播放列表添加到库中。
createQuery	创建新的 Query 对象。
getAll	检索包含库中所有媒体项的 Playlist 对象。
getAttributeStringCollection	检索一个 StringCollection 对象，该对象表示指定媒体类型中指定属性的所有值集。
getByAlbum	检索包含指定相册中的媒体项的 Playlist 对象。
getByAttribute	检索一个 Playlist 对象，该对象包含具有指定属性值的指定属性的媒体项。
getByAttributeAndMediaType	检索一个Playlist 对象，该对象包含具有指定属性和媒体类型的 Media 对象。
getByAuthor	检索包含指定作者的媒体项的 Playlist 对象。
getByGenre	检索包含具有指定流派的媒体项的 Playlist 对象。
getByName	检索包含具有指定名称的媒体项的 Playlist 对象。
getMediaAtom	检索指定属性驻留在可用属性集中的索引。
getPlaylistByQuery	检索一个 Playlist 对象，该对象包含与查询条件匹配的 Media 对象。
getStringCollectionByQuery	检索包含与查询条件匹配的字符串的 StringCollection 对象。
isDeleted	检索一个值，该值指示指定的媒体项是否位于已删除邮件文件夹中。
删除	从媒体集合中删除项。
setDeleted	将指定的媒体项移动到已删除邮件文件夹。

 

可通过以下属性访问 MediaCollection 对象。

Object	属性
播放器	mediaCollection

 

另请参阅

脚本的对象模型参考