Download Collection. startDownload-Methode

Hinweis

In diesem Abschnitt werden die-Funktionen beschrieben, die für die Verwendung durch Online Stores Die Verwendung dieser Funktion außerhalb des Kontexts eines Online Stores wird nicht unterstützt.

Die startDownload -Methode fügt einen Download zur Warteschlange.

Syntax

retVal = DownloadCollection.startDownload(
  sourceURL,
  type
)

Parameter

SourceUrl [ in]

Zeichenfolge , die die URL des Downloads angibt.

Typ [ in]

Zeichenfolge , die den Typ des Downloads angibt. Enthält einen der folgenden Werte.

Wert BESCHREIBUNG
background (Windows XP und höher.) Der Download erfolgt als Hintergrundprozess, wenn die Prozessorzeit verfügbar wird. Download Zustände bleiben auch dann erhalten, wenn Windows Media Player oder Windows XP heruntergefahren wird.
Echt Zeit (Alle unterstützten Betriebssysteme) Der Download erfolgt alle auf einmal. Zwischen den Sitzungen bleiben keine Download Zustände erhalten.

Rückgabewert

Diese Methode gibt ein-Objekt vom Typ " Downloader " zurück.

Bemerkungen

Wenn ein neuer Download gestartet wird, fügt der Download-Manager ihn als Element der Download Sammlung hinzu, die den Download initiiert hat.

Es können nur die folgenden Digital Media-Formate heruntergeladen werden:

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

Der SourceUrl -Parameter unterstützt keine Unicode-codierten Zeichen folgen. Er muss auf gültigen Inhalt zeigen. Umleitungen werden nicht unterstützt.

Bei der Verwendung von Windows XP werden Audiodateien automatisch in die entsprechenden eigenen Musik -Unterordner auf der Grundlage von Metadatenwerten auf Dateiebene platziert. Video Dateien werden in \ den Zufallszahlen-Typ für den Musik \ Download eingefügt \ \ , wobei " Random Number " ein von Windows Media Player für jeden Benutzer generierter zufälliger Wert ist, und " Type " ist abhängig vom Downloadtyp entweder "Real Time" oder "Background".

Bei der Verwendung von Windows Media Player 9-Serie mit Windows 98 und Windows Millennium Edition (Me) werden Audiodateien und Videodateien in \ den \ \ Zufallszahlen-Typ "Musikdownload" eingefügt \ , wobei " Random Number " ein zufälliger Wert ist, der vom Player für jeden Benutzer generiert wird, und " Type " ist abhängig vom Downloadtyp entweder "Real Time" oder "Background".

Beachten Sie, dass Dateien möglicherweise auf der Grundlage der in der Datei enthaltenen Metadatenattribute und der vom Benutzer im Dialogfeld Optionen angegebenen Regeln umbenannt werden. Dateien, die keine Metadaten enthalten (z. b. Album oder Artist), werden möglicherweise in Ordner mit der Bezeichnung Unknown Artist oder Unknown Album verschoben.

Anforderungen

Anforderung Wert
Version
Windows Media Player 9-Serie oder höher
DLL
Wmp.dll

Siehe auch

Download Collection-Objekt

Download Item-Objekt