CurrentAppSimulator Klasse

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 simulierte Lizenzinformationen während des Tests abrufen können.

Anmerkung

Die CurrentAppSimulator 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 CurrentAppSimulator 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. 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

Anforderungen	Beschreibung
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 beim Entwickeln Ihrer App zu testen. Nachdem Sie Ihre App getestet und an den Microsoft Store übermittelt haben, müssen Sie die Instanzen von CurrentAppSimulator durch CurrentAppersetzen. Ihre App schlägt eine Zertifizierung fehl, wenn sie CurrentAppSimulator verwendet.

Wenn der CurrentAppSimulator verwendet wird, wird der anfängliche Lizenzierungsstatus der App in einer Datei mit dem Namen WindowsStoreProxy.xmlbeschrieben. 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 das in WindowsStoreProxy.xmlbeschriebene Zurückgesetzt.

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

Eigenschaften

Name	Beschreibung
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, erhalten CurrentApp.AppId- die GUID generiert, die beim Onboarding der App generiert und zum Auflisten Ihrer App im Windows Store-Katalog verwendet wird. Anmerkung 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, wie von der Simulation bereitgestellt.
LinkUri	Ruft den simulierten URI (Uniform Resource Identifier) ab, der eine Microsoft Store-Eintragsseite für die aktuelle App darstellt.

Name

Beschreibung

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, erhalten CurrentApp.AppId- die GUID generiert, die beim Onboarding der App generiert und zum Auflisten Ihrer App im Windows Store-Katalog verwendet wird.

Anmerkung

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, wie von der Simulation bereitgestellt.

LinkUri

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

Methoden

Name	Beschreibung
GetAppPurchaseCampaignIdAsync()	Ruft die Kampagnen-ID für die aktuelle App ab.
GetAppReceiptAsync()	Erstellt den asynchronen Vorgang, den der Benutzer verwenden kann, um das Anfordern aller Quittungen für diese App und alle In-App-Produktkäufe zu simulieren. Beispiele für die Verwendung von Beleginformationen finden Sie unter Verwenden von Bestätigungen zum Überprüfen von Produktkäufen.
GetProductReceiptAsync(String)	Erstellt den asynchronen Vorgang, den der Benutzer verwenden kann, um das Anfordern des Belegs für die angegebene Produkt-ID zu simulieren. 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 konsumierbaren In-App-Produkte zurück, die nicht lokal erfüllt wurden.
LoadListingInformationAsync()	Lädt die simulierten App-Eintragsinformationen 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 Eintragsinformationen für Produkte bereitgestellt, die über In-App-Produkte verfügbar sind. Anmerkung Für Simulationszwecke 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-Eintragsinformationen asynchron und gibt In-App-Produkte in der ProductListings Auflistung zurück, die allen bereitgestellten Schlüsselwörtern entsprechen.
LoadListingInformationByProductIdsAsync(IIterable<String>)	Lädt die simulierten App-Eintragsinformationen 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-, 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 (aber nicht überschreiben).
ReportConsumableFulfillmentAsync(String, Guid)	Simuliert die Benachrichtigung des 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.
RequestAppPurchaseAsync(Boolean)	Von Bedeutung In-App-Kauffunktionen werden in Anwendungen mit erhöhten Rechten nicht unterstützt. Erstellt den asynchronen Vorgang, der eine Benutzeranforderung zum Kauf einer Volllizenz für die aktuelle App simuliert.
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). 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)	Von Bedeutung In-App-Kauffunktionen werden in Anwendungen mit erhöhten Rechten nicht unterstützt. 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 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. 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.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?