Externes Objekt für Onlineshops vom Typ 1

[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.]

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 Online-Shops wird nicht unterstützt.

 

Das External-Objekt bietet Funktionen für Webseiten, die von einem Onlineshop bereitgestellt werden und in Windows Medienwiedergabe gehostet werden.

Das External-Objekt macht die folgenden Eigenschaften für Onlineshops vom Typ 1 verfügbar.

Eigenschaft Beschreibung
accountType Ruft den Kontotyp des aktuellen Benutzers ab.
appColorButtonHighlight Ruft die aktuelle Schaltflächen-Hervorhebungsfarbe für die Windows Medienwiedergabe-Benutzeroberfläche ab.
appColorButtonHoverFace Ruft die aktuelle Schaltflächen-Mauszeigerfarbe für die Windows Medienwiedergabe-Benutzeroberfläche ab.
appColorButtonShadow Ruft die aktuelle Schaltflächenschattenfarbe für die Windows Medienwiedergabe-Benutzeroberfläche ab.
appColorDark Ruft die aktuelle dunkel schattierte Farbe der Windows Medienwiedergabe-Benutzeroberfläche ab.
appColorLight Ruft die aktuelle hell schattierte Farbe der Windows Medienwiedergabe-Benutzeroberfläche ab.
appColorMedium Ruft die aktuelle mittlere schattige Farbe der Windows Medienwiedergabe Benutzeroberfläche ab.
basketTitle Ruft den Titel der Schaltfläche im Listenbereich (auch als Warenkorb bezeichnet) in Windows Medienwiedergabe ab.
filter Ruft den Suchfilter ab, der derzeit von Windows Medienwiedergabe verwendet wird.
ignoreIEHistory Gibt an, ob Windows Medienwiedergabe internet Explorer Verlauf ignorieren sollen.
libraryLocationID Ruft den Bezeichner eines bestimmten Medienelements ab, das derzeit in der Ansicht des Players angezeigt wird.
libraryLocationType Ruft eine Bibliotheksspeicherortkonstante ab, die den Typ der aktuellen Ansicht in Windows Medienwiedergabe angibt.
pluginRunning Ruft einen Wert ab, der angibt, ob das Plug-In des Onlineshops ausgeführt wird.
selectedItemID Ruft den Bezeichner des Medienelements ab, das derzeit in Windows Medienwiedergabe ausgewählt ist.
selectedItemType Ruft den Typ des Medienelements ab, das derzeit in Windows Medienwiedergabe ausgewählt ist.
Aufgabe Ruft den Namen des aktuellen Aufgabenbereichs ab.
templateBeingDisplayedInLocalLibrary Gibt an, ob der von der aktuellen Ermittlungsseite dargestellte Feed im Strukturansichtssteuerelement der lokalen Bibliothek angezeigt wird.
userLoggedIn Ruft einen Wert ab, der angibt, ob der Benutzer beim Online-Shop angemeldet ist.
version Ruft die aktuelle Version von Windows Medienwiedergabe ab.
viewParameters Ruft Parameter ab, die der aktuellen Ansicht in Windows Medienwiedergabe zugeordnet sind.

 

Das External-Objekt macht die folgenden Methoden für Onlineshops vom Typ 1 verfügbar.

Methode Beschreibung
addToBasket Fügt dem Listenbereich Medienelemente (auch als Warenkorb bezeichnet) in Windows Medienwiedergabe hinzu.
attemptLogin Zeigt ein Dialogfeld an, damit der Benutzer versuchen kann, sich beim Online-Store anzumelden.
Authentifizieren Initiiert einen Versuch, den Benutzer zu authentifizieren.
kaufen Initiiert den Kauf einer Gruppe von Medienelementen.
cancelNavigate Informiert Windows Medienwiedergabe, dass keine neue Ermittlungsseite angezeigt werden soll, obwohl sich die Ansicht im Player geändert hat.
changeView Ändert die Ansicht in Windows Medienwiedergabe.
changeViewOnlineList Ändert die Ansicht in Windows Medienwiedergabe, um eine dynamisch vom Online-Shop generierte Liste anzuzeigen.
Herunterladen Initiiert den Download einer Gruppe von Medienelementen.
play Weist Windows Medienwiedergabe an, eine Reihe von Medienelementen wiederzugeben.
saveCurrentViewToLibrary Erstellt eine Wiedergabeliste aus den Medienelementen in der aktuellen Ansicht und speichert die Wiedergabeliste in der lokalen Bibliothek.
Sendmessage Sendet eine Nachricht an das Plug-In des Online-Shops.
showPopup Weist Windows Medienwiedergabe an, eine Popupwebseite anzuzeigen, d. h. eine Webseite, die in einem separaten Fenster angezeigt wird.

 

Das External-Objekt macht die folgenden Ereignisse für Onlineshops vom Typ 1 verfügbar.

Ereignis Beschreibung
OnChangeViewError Tritt auf, wenn ein Aufruf der External.ChangeView-Methode zu einem Fehler führt.
OnChangeViewOnlineListError Tritt auf, wenn ein Aufruf der External.ChangeViewOnlineList-Methode zu einem Fehler führt.
OnColorChange Tritt auf, wenn sich die Farbe der Windows Medienwiedergabe Benutzeroberfläche ändert.
OnLoginChange Tritt auf, wenn sich die Anmeldung des Benutzers status ändert oder wenn ein Anmeldeversuch fehlschlägt.
OnSendMessageComplete Tritt auf, wenn der Online-Shop die Verarbeitung einer Nachricht abgeschlossen hat.
OnViewChange Tritt auf, wenn sich die Ansicht in Windows Medienwiedergabe ändert.

 

Referenz für Typ 1-Onlineshops

Remoting des Windows Media Player-Steuerelements