Windows Medienwiedergabe BITS-Auftragskonvention

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Windows Medienwiedergabe können digitale Medienelemente automatisch herunterladen und der Bibliothek hinzufügen, wenn Sie den intelligenten Hintergrundübertragungsdienst (Background Intelligent Transfer Service, BITS) verwenden. Um dieses Feature nutzen zu können, müssen Sie Ihren Auftrag der BITS-Übertragungswarteschlange hinzufügen und IBackgroundCopyJob::SetDescription aufrufen, um eine Beschreibungszeichenfolge bereitzustellen, die das richtige Format verwendet.

Hinweis

In diesem Abschnitt werden Funktionen beschrieben, die für die Verwendung durch Onlineshops entwickelt wurden. Die Verwendung dieser Funktionalität außerhalb des Kontexts eines Onlineshops wird nicht unterstützt.

 

Syntax

::WMP_JOB:1:serviceId:Provider:AlbumArtist:AlbumTitle:TrackNumber:Title:Duration:Rating

Parameter

serviceId

Ein zufällig generierter 32-Bit-Wert, der Windows Medienwiedergabe verwendet, um den Dienst zu identifizieren.

Provider

Der Anbietername. Dieser Wert muss mit einem gültigen Namen des Onlineshopschlüssels übereinstimmen.

AlbumArtist

Der Name des primären Künstlers für das Album.

AlbumTitle

Der Titel des Albums.

TrackNumber

Die CD-Titelnummer.

Titel

Der Titel des Inhalts.

Dauer

Die Dauer des Inhalts.

Bewertung

Die Bewertung für den Inhalt.

Bemerkungen

Wenn Windows Medienwiedergabe 10 oder höher BITS zum Herunterladen von Inhalten verwendet, werden die Aufträge in der Übertragungswarteschlange aufgelistet und die Beschreibungszeichenfolge für jeden Auftrag überprüft. Wenn die Beschreibungszeichenfolge mit der erwarteten Konvention übereinstimmt, lädt Windows Medienwiedergabe den Inhalt herunter.

Sie müssen jedem BITS-Auftrag nur eine digitale Mediendatei zum Download hinzufügen.

Nachdem Sie einen BITS-Auftrag mit dieser Konvention gestartet haben, müssen Sie den Auftrag Windows Medienwiedergabe abschließen lassen. Windows Medienwiedergabe entfernt auch den Auftrag aus der BITS-Warteschlange, verschiebt die heruntergeladene Datei an den Speicherort, an dem kopierte Musik gespeichert wird, und fügt die heruntergeladene Datei der Bibliothek hinzu.

Der serviceId-Parameter muss einen 32-Bit-Wert ungleich null enthalten. Es wird empfohlen, die Funktion CryptGenRandom zu verwenden, um diesen Wert zu erstellen.

Der Dateiname, den Sie mit dem parameter localName von IBackgroundCopyJob::AddFile angeben, muss die Dateinamenerweiterung .wma, .wmv, .mp3 oder .asf aufweisen.

Die verbleibenden Parameter sind so konzipiert, dass sie Metadatenwerte enthalten, die sich auf den Inhalt beziehen. Sie können diese Werte mithilfe von DownloadItem.getItemInfo von der Webseite Ihres Onlineshops abrufen. Sie können die richtige Downloadsammlung abrufen, indem Sie DownloadManager.getDownloadCollection aufrufen und serviceId als collectionId-Parameter angeben.

Windows Medienwiedergabe überprüft die BITS-Warteschlange regelmäßig, während der Player ausgeführt wird. Um sicherzustellen, dass Windows Medienwiedergabe die BITS-Warteschlange auf Downloadaufträge überprüft, sollten Sie einen Wert im folgenden Registrierungsunterschlüssel erstellen:

HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services

Der Wert sollte wie folgt erstellt werden.

Name Typ Beschreibung
AktualisierenHerunterladen DWORD Gibt an, ob Windows Medienwiedergabe die BITS-Warteschlange auf Downloadaufträge untersuchen soll. Wenn der Wert 0 (null) ist, überprüft der Player die BITS-Warteschlange nicht. Der Player muss die Warteschlange überprüfen, wenn der Wert ungleich null ist.

 

Sie können die folgende alternative Syntax verwenden, um BITS-Aufträge hinzuzufügen, die Windows Medienwiedergabe nicht abgeschlossen, aber für die einfach status Informationen angezeigt werden:

::WMP_STATUS:1:serviceId:Provider:AlbumArtist:AlbumTitle:TrackNumber:Title:Duration:Rating

Wenn Sie die obige Syntax verwenden, müssen Sie Code schreiben, um den BITS-Download abzuschließen, den Inhalt auf dem Computer des Benutzers zu organisieren und den Inhalt bei Bedarf der Bibliothek hinzuzufügen.

CryptGenRandom

DownloadItem.getItemInfo

DownloadManager.getDownloadCollection

Referenz für Typ 2-Onlineshops