MediaCollection.add 方法
[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能,Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
add 方法将新的媒体项或播放列表添加到库中。
语法
retVal = MediaCollection.add(
path
)
参数
-
path [in]
-
包含路径的字符串。
返回值
此方法返回 一个 Media 对象。
备注
此方法在给定文件路径的情况下,将现有媒体项或播放列表加载到库中。 此方法不会移动或更改文件。 如果给定无效的本地路径,则此方法失败,但在将数字媒体文件添加到库之前,不会检查其有效性。
此方法同时接受静态和自动播放列表文件。 PlaylistCollection。importPlaylist 方法还可用于将静态播放列表添加到库中。
若要使用此方法,需要对库的完全访问权限。 有关详细信息,请参阅 库访问。
示例
以下 Microsoft JScript 示例将三个媒体对象添加到Windows 媒体播放器媒体集合。 使用 ID=“Player”创建 Player 对象。
// Adding a media object using a website.
Player.mediaCollection.add("https://www.proseware.com/Media/Laure.wma");
// Adding a media object from a local network.
// You must add an escape sequence of a backslash for
// every original backslash.
Player.mediaCollection.add("\\\\yourservername\\Public\\Jeanne.wma");
// Adding a media object from a file on a local drive.
// Be sure to add appropriate escape sequences.
Player.mediaCollection.add("C:\\WMSDK\\WMPSDK\\docs\\samples\\media\\house.wma");
要求
要求 | 值 |
---|---|
版本 |
Windows 媒体播放器版本 7.0 或更高版本。 |
DLL |
|
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈