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
Wmp.dll

另请参阅

DownloadCollection 对象

DownloadItem 对象