DownloadCollection.startDownload 方法
[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
注意
本部分介绍专为在线商店使用而设计的功能。 不支持在在线商店的上下文之外使用此功能。
startDownload 方法将下载排队。
语法
retVal = DownloadCollection.startDownload(
sourceURL,
type
)
parameters
-
sourceURL [in]
-
指定下载 URL 的字符串。
-
type [in]
-
指定下载类型的字符串。 包含以下值之一。
Value 说明 background (Windows XP 及更高版本。) 当处理器时间可用时,下载作为后台进程进行。 即使Windows 媒体播放器或 Windows XP 已关闭,下载状态也会保留。 实时 (所有支持的操作系统。) 一次下载。 会话之间不会保留任何下载状态。
返回值
此方法返回 DownloadItem 对象。
备注
启动新下载时,下载管理器将其作为项添加到启动下载的下载集合。
只能下载以下数字媒体格式:
- 高级流格式 (ASF)
- MP3
- Windows Media 音频 (WMA)
- Windows Media 视频 (WMV)
sourceURL 参数不支持 Unicode 编码的字符串。 它必须指向有效内容。 不支持重定向。
使用 Windows XP 时,音频文件会根据文件级元数据值自动放入相应的 “我的音乐” 子文件夹中。 视频文件放入 \My Music\download\random number\类型,其中随机数是Windows 媒体播放器为每个用户生成的随机值,类型为“实时”或“背景”,具体取决于下载类型。
将 Windows 媒体播放器 9 系列与 Windows 98 和 Windows Millennium Edition (ME) 配合使用时,音频和视频文件将放入 \My Music\download\random number\类型,其中随机数是播放器为每个用户生成的随机值,类型为“实时”或“背景”,具体取决于下载类型。
请注意,可以根据文件中包含的元数据属性重命名文件,以及用户在 “选项 ”对话框中指定的规则。 不包含元数据的文件(如 专辑 或 艺术家)可能会移动到标记为“未知艺术家”或“未知专辑”的文件夹。
要求
要求 | 值 |
---|---|
版本 |
Windows 媒体播放器 9 系列或更高版本 |
DLL |
|
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将推出:在整个 2024 年,我们将逐步取消以“GitHub 问题”作为内容的反馈机制,并将其替换为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈