Kaufen von Medieninhalten

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

Wenn Windows Medienwiedergabe Musikinhalte in der Bibliotheksstrukturansicht anzeigt, enthält die Benutzeroberfläche Elemente, auf die der Benutzer klicken kann, um den Inhalt zu kaufen. Beispielsweise kann der Benutzer auf eine Schaltfläche klicken, um einen einzelnen Song zu kaufen oder ein ganzes Album zu kaufen.

Wenn der aktive Online-Shop ein Store vom Typ 1 ist, hat Windows Medienwiedergabe Zugriff auf Titel-, Album- und Listenpreise im Katalog des Onlineshops. Bei diesen Preisen im Katalog handelt es sich um Zeichenfolgen, die ein Format aufweisen, das nur vom Online-Shop verstanden wird. Windows Medienwiedergabe interpretiert keine Preiszeichenfolgen, sondern zeigt sie lediglich in Benutzeroberflächenelementen wie Schaltflächen zum Kaufen an.

Wenn Windows Medienwiedergabe einen Kauf für eine Reihe von Medienelementen einrichtet, übergibt er die IDs und Preise der Medienelemente an das Inhaltspartner-Plug-In, indem IWMPContentPartner::CanBuySilent aufgerufen wird. Zu diesem Zeitpunkt kann das Plug-In die vom Player bereitgestellten Preise überprüfen. Dies sind die Preise, die der Benutzer erwartet; d. h. die Preise, die der Player dem Benutzer angezeigt hat. Basierend auf den vom Player bereitgestellten Medien-IDs und Preisen berechnet das Plug-In einen Gesamtpreis, den es im Parameter bstrTotalPrice an den Player zurückgibt. Die Preise, die der Spieler an CanBuySilent übergibt, stellen das Plug-In mit Informationen zur Verfügung, aber sie verpflichten das Plug-In nicht, einen bestimmten Gesamtpreis zurückzugeben. Das Plug-In kann den Gesamtpreis nach Bedarf berechnen.

Neben der Berechnung des Gesamtpreises eines Kaufs bestimmt CanBuySilent , ob die Beschaffung im Stillen erfolgen kann; das heißt, ohne dass ein Dialogfeld angezeigt wird. Wenn CanBuySilentTrue zurückgibt, ändert Windows Medienwiedergabe einfach den Text auf der Schaltfläche Kaufen, um den Benutzer zur Bestätigung des Kaufs aufzufordern. Wenn CanBuySilentFalse zurückgibt, wird Windows Medienwiedergabe ein Dialogfeld angezeigt, in dem der Benutzer aufgefordert wird, den Kauf zu bestätigen. Das Dialogfeld stellt dem Benutzer Informationen zur Verfügung, die den Kauf wie die Anzahl der Alben, die Anzahl der einzelnen Titel und den Gesamtpreis (wie vom Plug-In zurückgegeben) zusammenfassen.

Nachdem der Benutzer den Kauf bestätigt hat, ruft der Player IWMPContentPartner::Buy auf. Dieser Methodenaufruf stellt das Plug-In mit der gleichen Inhaltscontainerliste wie CanBuySilent bereit. Beim Aufrufen von Buy stellt Windows Medienwiedergabe auch ein Cookie (einfach einen DWORD-Wert, eindeutig für die Sitzung) bereit, mit dem das Plug-In die Transaktion identifizieren kann. Nach Abschluss der Transaktion muss das Plug-In IWMPContentPartnerCallback::BuyComplete aufrufen und dabei den ursprünglichen Cookiewert für den dwBuyCookie-Parameter übergeben, um den Player darüber zu informieren, dass die Transaktion abgeschlossen ist.

Zugehörige Themen

Programmierhandbuch für Typ 1-Onlineshops