DownloadCollection.startDownload メソッド

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

注意

このセクションでは、オンライン ストアで使用するために設計された機能について説明します。 オンライン ストアのコンテキスト外でのこの機能の使用はサポートされていません。

startDownload メソッドは、ダウンロードをキューに入れます。

構文

retVal = DownloadCollection.startDownload(
  sourceURL,
  type
)

パラメーター

sourceURL [in]

ダウンロードの URL を指定する文字列。

type [in]

ダウンロードの種類を指定する文字列。 次のいずれかの値が格納されます。

値	説明
background	(Windows XP 以降)。ダウンロードは、プロセッサ時間が使用可能になるとバックグラウンド プロセスとして発生します。 Windows メディア プレーヤーまたは Windows XP がシャットダウンされた場合でも、ダウンロードの状態は保持されます。
リアルタイム	(サポートされているすべてのオペレーティング システム。ダウンロードは一度にすべて行われます。 セッション間でダウンロード状態は保持されません。

戻り値

このメソッドは DownloadItem オブジェクトを返します。

解説

新しいダウンロードが開始されると、ダウンロード マネージャーによって、ダウンロードを開始したダウンロード コレクションにアイテムとして追加されます。

ダウンロードできるのは、次のデジタル メディア形式のみです。

• Advanced Systems Format (ASF)
• MP3
• Windows Media Audio (WMA)
• Windows Media Video (WMV)

sourceURL パラメーターは、Unicode でエンコードされた文字列をサポートしていません。 有効なコンテンツを指す必要があります。 リダイレクトはサポートされていません。

Windows XP を使用すると、ファイル レベルのメタデータ値に基づいて、オーディオ ファイルが適切な My Music サブフォルダーに自動的に配置されます。 ビデオ ファイルは \My Music\download\random number\型に配置されます。乱数はユーザーごとにWindows メディア プレーヤーによって生成されるランダムな値であり、種類はダウンロードの種類に応じて "リアルタイム" または "バックグラウンド" です。

Windows 98 および Windows Millennium Edition (ME) で Windows メディア プレーヤー 9 シリーズを使用する場合、オーディオ ファイルとビデオ ファイルは \My Music\download\random number\型に配置されます。ここで、乱数はユーザーごとにプレーヤーによって生成されるランダムな値であり、種類はダウンロードの種類に応じて "リアルタイム" または "バックグラウンド" です。

ファイルの名前は、ファイルに含まれるメタデータ属性と、[ オプション] ダイアログ ボックスでユーザーが指定したルールに基づいて変更できます。 アルバムやアーティストなどのメタデータを含まないファイルは、Unknown Artist または Unknown Album というラベルのフォルダーに移動できます。

必要条件

要件	値
バージョン	Windows メディア プレーヤー 9 シリーズ以降
[DLL]	Wmp.dll

関連項目

DownloadCollection オブジェクト

DownloadItem オブジェクト