CurrentAppSimulator Klasse

Referenz

Definition

Namespace:: Windows.ApplicationModel.Store

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.

Bearbeiten

Definiert Methoden und Eigenschaften, die zum Instanziieren eines Objekts verwendet werden, mit dem Sie während des Tests simulierte Lizenzinformationen abrufen können.

Hinweis

Die CurrentAppSimulator-Klasse und die anderen Typen im Windows.ApplicationModel.Store-Namespace werden nicht mehr mit neuen Features aktualisiert. Wenn Ihr Projekt Windows 10 Anniversary Edition (10.0; Build 14393) oder eine höhere Version in Visual Studio (d. h. Sie zielen auf Windows 10 Version 1607 oder höher ab), wird empfohlen, stattdessen den Windows.Services.Store Namespace zu verwenden. Weitere Informationen finden Sie unter In-App-Käufe und Testversionen. Die CurrentAppSimulator-Klasse wird nicht in Windows-Desktopanwendungen unterstützt, die die Desktop-Brücke verwenden, oder in Apps oder Spielen, die eine Entwicklungssandbox in Partner Center verwenden (dies ist z. B. bei jedem 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 CurrentAppSimulator 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 CurrentAppSimulator 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 CurrentAppSimulator

Public Class CurrentAppSimulator

Vererbung: Object Platform::Object IInspectable CurrentAppSimulator

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Bis die App im Microsoft Store aufgeführt wurde, funktioniert das CurrentApp-Objekt nicht in der App. Verwenden Sie den CurrentAppSimulator, um die Lizenzierung Und In-App-Produkte Ihrer App zu testen, während Sie Ihre App entwickeln. Nachdem Sie Ihre App getestet haben und sie an den Microsoft Store übermitteln, müssen Sie die Instanzen von CurrentAppSimulator durch CurrentApp ersetzen. Ihre App wird nicht zertifiziert, wenn sie CurrentAppSimulator verwendet.

Wenn der CurrentAppSimulator verwendet wird, wird der anfängliche Lizenzierungsstatus der App in einer Datei mit dem Namen WindowsStoreProxy.xml beschrieben. CurrentAppSimulator-Methoden, die den Lizenzstatus ändern, z. B. durch Kauf einer Lizenz oder Behandeln eines In-App-Kaufs, aktualisieren nur den Lizenzstatus des Objekts im Arbeitsspeicher. Der Inhalt von WindowsStoreProxy.xml wird nicht geändert. Wenn die App erneut gestartet wird, wird der Lizenzstatus auf den Status zurückgesetzt, der in WindowsStoreProxy.xml beschrieben ist.

Weitere Informationen zur WindowsStoreProxy.xml-Datei finden Sie unter Verwenden der WindowsStoreProxy.xml-Datei mit CurrentAppSimulator.

Eigenschaften

AppId

Ruft eine simulierte App-ID ab. Da CurrentAppSimulator nur für Tests während der App-Entwicklung vorgesehen ist, enthält die zurückgegebene CurrentAppSimulator.AppId nur 0's.

Sobald Ihre App im Windows Store aufgeführt ist, erhält CurrentApp.AppId die GUID , die während des App-Boardings generiert wurde und zum Auflisten Ihrer App im Windows Store-Katalog verwendet wird.

Hinweis

App-Updates oder Änderungen an der App-Beschreibung führen nicht zu einer Änderung der CurrentApp.AppId.

LicenseInformation

Ruft die simulierten Lizenzmetadaten für die aktuelle App ab, die von der Simulation bereitgestellt werden.

LinkUri

Ruft den simulierten URI (Uniform Resource Identifier) ab, der eine Microsoft Store-Eintragsseite für die aktuelle App darstellt.

Methoden

GetAppPurchaseCampaignIdAsync()	Ruft die Kampagnen-ID der Promotion für die aktuelle App ab.
GetAppReceiptAsync()	Erstellt den asynchronen Vorgang, mit dem der Benutzer die Anforderung aller Belege für diese App und alle In-App-Produktkäufe simulieren kann. Beispiele für die Verwendung von Beleginformationen finden Sie unter Verwenden von Belegen zum Überprüfen von Produktkäufen.
GetProductReceiptAsync(String)	Erstellt den asynchronen Vorgang, mit dem der Benutzer die Anforderung des Belegs für die angegebene Produkt-ID simulieren kann. Beispiele für die Verwendung von Beleginformationen finden Sie unter Verwenden von Belegen zum Überprüfen von Produktkäufen.
GetUnfulfilledConsumablesAsync()	Gibt eine Liste der erworbenen verbrauchsbaren In-App-Produkte zurück, die nicht lokal erfüllt wurden.
LoadListingInformationAsync()	Lädt die simulierten App-Auflistungsinformationen asynchron. Das zurückgegebene ListingInformation-Objekt enthält Listeninformationen (z. B. Name, Preis, Altersfreigabe), die für den Markt, in dem sich der Benutzer derzeit befindet, spezifisch sind. Darüber hinaus werden informationen zu Produkten bereitgestellt, die über In-App-Produkte verfügbar sind. Hinweis Zu Simulationszwecken verwendet diese Methode das -Element in der WindowsStoreProxy.xml-Datei als Datenquelle für die Member des zurückgegebenen Objekts. Weitere Informationen finden Sie in den Codebeispielen in CurrentAppSimulator.
LoadListingInformationByKeywordsAsync(IIterable<String>)	Lädt die simulierten App-Auflistungsinformationen asynchron und gibt In-App-Produkte in der ProductListings-Auflistung zurück, die allen angegebenen Schlüsselwörtern entsprechen.
LoadListingInformationByProductIdsAsync(IIterable<String>)	Lädt die simulierten App-Auflistungsinformationen asynchron und gibt verfügbare In-App-Produkte in der ProductListings-Auflistung zurück, die mit einer der angegebenen Produkt-IDs übereinstimmen.
ReloadSimulatorAsync(StorageFile)	Lädt den Simulator mithilfe einer StorageFile-Datei , die die WindowsStoreProxy.xml-Datei enthält, neu. Wenn Sie diese Methode nicht aufrufen, um Ihre eigene Datei zu laden, erstellt/lädt der Simulator eine WindowsStoreProxy.xml Datei, die eine Reihe von Standardwerten enthält.
ReportConsumableFulfillmentAsync(String, Guid)	Simuliert die Benachrichtigung des Microsoft Store, dass der Kauf eines konsumierbaren Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) erfüllt ist und dass der Benutzer das Recht hat, auf die Inhalte zuzugreifen.
RequestAppPurchaseAsync(Boolean)	Erstellt den asynchronen Vorgang, der eine Benutzeranforderung zum Erwerb einer vollständigen Lizenz für die aktuelle App simuliert.
RequestProductPurchaseAsync(String)	Erstellt den asynchronen Vorgang, der die Benutzeroberfläche anzeigt, die zum Simulieren des Kaufs eines Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) aus dem Microsoft Store verwendet wird.
RequestProductPurchaseAsync(String, Boolean)	Hinweis [RequestProductPurchaseAsync(String, Boolean) kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen RequestProductPurchaseAsync(String). Erstellt den asynchronen Vorgang, der die Benutzeroberfläche anzeigt, die zum Simulieren des Kaufs eines Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) aus dem Microsoft Store verwendet wird.
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)	Erstellt den asynchronen Vorgang, der die Benutzeroberfläche anzeigt, die zum Simulieren des Kaufs eines Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) aus dem Microsoft Store verwendet wird. Diese Überladung umfasst Parameter, die Sie verwenden können, um Details für ein bestimmtes Angebot in einem großen Katalog von In-App-Käufen anzuzeigen, der durch einen einzelnen Produkteintrag im Store dargestellt wird.

Gilt für: