CurrentApp Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert Methoden und Eigenschaften, mit denen Sie Lizenzinformationen zu der aktuellen App abrufen und In-App-Produktkäufe ausführen können.
Anmerkung
Die CurrentApp Klasse und die anderen Typen im Windows.ApplicationModel.Store-Namespace werden nicht mehr mit neuen Features aktualisiert. Wenn Ihr Projekt auf Windows 10 Anniversary Edition ausgerichtet ist (10.0; Build 14393) oder einer höheren Version in Visual Studio (d. h., Sie verwenden Windows 10, Version 1607 oder höher), es wird empfohlen, stattdessen den Windows.Services.Store-Namespace zu verwenden. Weitere Informationen finden Sie unter In-App-Käufe und Testversionen. Die CurrentApp Klasse wird in Windows-Desktopanwendungen, die die Desktop-Brücke oder in Apps oder Spielen verwenden, die eine Entwicklungs-Sandbox in Partner Center- verwenden , nicht unterstützt (z. B. für jedes Spiel, das in Xbox Live integriert ist). Diese Produkte müssen den Windows.Services.Store Namespace verwenden, um In-App-Käufe und Testversionen zu implementieren.
public ref class CurrentApp abstract sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CurrentApp final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class CurrentAppPublic Class CurrentApp- Vererbung
- Attribute
Windows-Anforderungen
| Anforderungen | Beschreibung |
|---|---|
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Hinweise
Dieses Objekt ruft seine Daten aus dem Microsoft Store ab, daher müssen Sie über ein Entwicklerkonto verfügen, und die App muss im Microsoft Store veröffentlicht werden. Bevor Sie an den Microsoft Store übermitteln, können Sie Ihren Code mit einer simulierten Version dieser Klasse testen (deren Status aus einer XML-Datei initialisiert wird). Siehe CurrentAppSimulator.
Versionsverlauf
| Windows-Version | SDK-Version | Mehrwert |
|---|---|---|
| 1511 | 10586 | GetCustomerCollectionsIdAsync |
| 1511 | 10586 | GetCustomerPurchaseIdAsync |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AppId |
Ruft die vom Windows Store generierte GUID ab, wenn Ihre App für den Eintrag im Windows Store zertifiziert wurde. Anmerkung Sobald sich Ihre App im Windows Store befindet, führen zukünftige App-Updates oder Änderungen an der App-Beschreibung nicht zu einer Änderung der CurrentApp.AppId. |
| LicenseInformation |
Ruft die Lizenzmetadaten für die aktuelle App ab. |
| LinkUri |
Ruft den URI (Uniform Resource Identifier) der Eintragsseite der App im Webkatalog des Windows Store ab. |
Methoden
| Name | Beschreibung |
|---|---|
| GetAppPurchaseCampaignIdAsync() |
Ruft die Kampagnen-ID für die aktuelle App ab. |
| GetAppReceiptAsync() |
Fordert alle Belege für den Kauf der App und aller In-App-Produkte an. Beispiele für die Verwendung von Beleginformationen finden Sie unter Verwenden von Bestätigungen zum Überprüfen von Produktkäufen. |
| GetCustomerCollectionsIdAsync(String, String) |
Ruft einen Microsoft Store-ID-Schlüssel ab, der zum Abfragen von Produktberechtigungen oder zum Verbrauch von Produktberechtigungen verwendet werden kann, die dem aktuellen Benutzer gehören. |
| GetCustomerPurchaseIdAsync(String, String) |
Ruft einen Microsoft Store-ID-Schlüssel ab, der zum Erteilen von Berechtigungen für kostenlose Produkte im Namen des aktuellen Benutzers verwendet werden kann. |
| GetProductReceiptAsync(String) |
Fordert den Beleg für die angegebene Produkt-ID an. Beispiele für die Verwendung von Beleginformationen finden Sie unter Verwenden von Bestätigungen zum Überprüfen von Produktkäufen. |
| GetUnfulfilledConsumablesAsync() |
Gibt eine Liste der gekauften In-App-Produkte zurück, die nicht als erfüllt an den Microsoft Store gemeldet wurden. |
| LoadListingInformationAsync() |
Lädt die Eintragsinformationen der App asynchron. Das zurückgegebene ListingInformation -Objekt enthält Eintragsinformationen (z. B. Name, Preis, Altersfreigabe) spezifisch für den Markt, in dem sich der Benutzer derzeit befindet. Darüber hinaus werden auch die Eintragsinformationen für verfügbare In-App-Produkte bereitgestellt. |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
Lädt die App-Eintragsinformationen asynchron und gibt Features und Produkte in der ProductListings Auflistung zurück, die allen bereitgestellten Schlüsselwörtern entsprechen. |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
Lädt die App-Eintragsinformationen asynchron und gibt Features und Produkte in der ProductListings Auflistung zurück, die mit einer der angegebenen Produkt-IDs übereinstimmen. |
| ReportConsumableFulfillmentAsync(String, Guid) |
Benachrichtigt den Microsoft Store, dass der Kauf eines Verbrauchs-Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) erfüllt ist und dass der Benutzer das Recht hat, auf die Inhalte zuzugreifen. |
| ReportProductFulfillment(String) |
Benachrichtigt den Microsoft Store, dass die Anwendung das In-App-Produkt erfüllt hat. Dieses Produkt kann erst wieder gekauft werden, wenn die App die Erfüllung mit dieser Methode bestätigt hat. |
| RequestAppPurchaseAsync(Boolean) |
Von Bedeutung In-App-Kauffunktionen werden in Anwendungen mit erhöhten Rechten nicht unterstützt. Fordert den Kauf einer vollständigen App-Lizenz an. |
| RequestProductPurchaseAsync(String, Boolean) |
Von Bedeutung In-App-Kauffunktionen werden in Anwendungen mit erhöhten Rechten nicht unterstützt. Anmerkung [RequestProductPurchaseAsync(String, Boolean) kann nach Windows 8.1 für Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen RequestProductPurchaseAsync(String). Fordert den Kauf eines Add-Ons an (auch als In-App-Produkt oder IAP bezeichnet). Darüber hinaus zeigt das Aufrufen dieser Methode die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird. |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Von Bedeutung In-App-Kauffunktionen werden in Anwendungen mit erhöhten Rechten nicht unterstützt. Fordert den Kauf eines Add-Ons an (auch als In-App-Produkt oder IAP bezeichnet). Darüber hinaus zeigt das Aufrufen dieser Methode die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird. Diese Überladung enthält Parameter, mit denen Sie Details für ein bestimmtes Angebot in einem großen Katalog von In-App-Käufen anzeigen können, die durch einen einzelnen Produkteintrag im Store dargestellt werden. |
| RequestProductPurchaseAsync(String) |
Von Bedeutung In-App-Kauffunktionen werden in Anwendungen mit erhöhten Rechten nicht unterstützt. Fordert den Kauf eines Add-Ons an (auch als In-App-Produkt oder IAP bezeichnet). Darüber hinaus zeigt das Aufrufen dieser Methode die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird. |