CurrentAppSimulator Classe

Définition

Espace de noms:
Windows.ApplicationModel.Store
Modifier

Définit les méthodes et les propriétés utilisées pour instancier un objet que vous pouvez utiliser pour obtenir des informations de licence simulées pendant le test.

Note

Les CurrentAppSimulator classe et les autres types de l’espace de noms Windows.ApplicationModel.Store ne sont plus mis à jour avec de nouvelles fonctionnalités. Si votre projet cible Édition anniversaire Windows 10 (10.0 ; Build 14393) ou une version ultérieure dans Visual Studio (autrement dit, vous ciblez Windows 10, version 1607 ou ultérieure), nous vous recommandons d’utiliser l’espace de noms Windows.Services.Store à la place. Pour plus d’informations, consultez achats in-app et versions d’évaluation. La classe CurrentAppSimulator n’est pas prise en charge dans les applications de bureau Windows qui utilisent le Desktop Bridge ou dans des applications ou des jeux qui utilisent un bac à sable de développement dans Espace partenaires (par exemple, il s’agit du cas pour tout jeu qui s’intègre à Xbox Live). Ces produits doivent utiliser l’espace de noms Windows.Services.Store pour implémenter des achats et des versions d’évaluation dans l’application.

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
Héritage
Object Platform::Object IInspectable CurrentAppSimulator
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Configuration requise Description
Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Tant que l’application n’a pas été répertoriée dans le Microsoft Store, l’objet CurrentApp ne fonctionnera pas dans l’application. Utilisez CurrentAppSimulator pour tester les licences et les produits in-app de votre application pendant que vous développez votre application. Après avoir testé votre application et avant de l’envoyer au Microsoft Store, vous devez remplacer les instances de CurrentAppSimulator par CurrentApp. Votre application échouera la certification si elle utilise CurrentAppSimulator.

Lorsque CurrentAppSimulator est utilisé, l’état de licence initial de l’application est décrit dans un fichier nommé WindowsStoreProxy.xml. Méthodes CurrentAppSimulator qui modifient l’état de la licence, par exemple en achetant une licence ou en gérant un achat dans l’application, mettent à jour uniquement l’état de la licence de l’objet en mémoire. Le contenu de WindowsStoreProxy.xml n’est pas modifié. Lorsque l’application redémarre, l’état de la licence revient à ce qui est décrit dans WindowsStoreProxy.xml.

Pour plus d’informations sur le fichier WindowsStoreProxy.xml, consultez Using the WindowsStoreProxy.xml file with CurrentAppSimulator.

Propriétés

Nom Description
AppId

Obtient un ID d’application simulé. Étant donné que CurrentAppSimulator est destiné uniquement aux tests pendant le développement d’applications, le CurrentAppSimulator.AppId retourné ne contiendra que 0's.

Une fois que votre application est répertoriée dans le Windows Store, CurrentApp.AppId obtiendra le GUID généré lors de l’intégration de l’application et utilisé pour répertorier votre application dans le catalogue du Windows Store.

Note

Les mises à jour ou les modifications apportées à la description de l’application n’entraînent pas de modification duCurrentApp.AppId .
LicenseInformation

Obtient les métadonnées de licence simulées pour l’application actuelle, comme indiqué par la simulation.
LinkUri

Obtient l’URI (Uniform Resource Identifier) simulé qui représente une page de description du Microsoft Store pour l’application active.

Méthodes

Nom Description
GetAppPurchaseCampaignIdAsync()

Récupère l’ID de campagne de promotion de l’application actuelle.
GetAppReceiptAsync()

Crée l’opération asynchrone que l’utilisateur peut utiliser pour simuler la demande de tous les reçus pour cette application et tous les achats de produits dans l’application. Pour obtenir des exemples d’utilisation des informations de reçu, consultez Utilisation des reçus pour vérifier les achats de produits.
GetProductReceiptAsync(String)

Crée l’opération asynchrone que l’utilisateur peut utiliser pour simuler la demande de reçu pour l’ID de produit spécifié. Pour obtenir des exemples d’utilisation des informations de reçu, consultez Utilisation des reçus pour vérifier les achats de produits.
GetUnfulfilledConsumablesAsync()

Retourne une liste de produits consommables dans l’application qui n’ont pas été remplis localement.
LoadListingInformationAsync()

Charge les informations de liste d’applications simulées de manière asynchrone.

L’objet ListingInformation retourné contient des informations de référencement (par exemple, nom, prix, évaluation de l’âge) propres au marché dans lequel réside actuellement l’utilisateur. En outre, les informations de référencement des produits disponibles via des produits dans l’application sont également fournies.

Note

À des fins de simulation, cette méthode utilise l’élément du fichier WindowsStoreProxy.xml comme source de données pour les membres de l’objet retourné. Pour plus d’informations, consultez les exemples de code dans CurrentAppSimulator.
LoadListingInformationByKeywordsAsync(IIterable<String>)

Charge les informations de référencement d’applications simulées de manière asynchrone, en retournant des produits in-app dans les ProductListings collection qui correspondent à tous les mots clés fournis.
LoadListingInformationByProductIdsAsync(IIterable<String>)

Charge les informations de référencement d’applications simulées de manière asynchrone, en retournant les produits in-app disponibles dans les ProductListings collection qui correspondent à l’un des ID de produits donnés.
ReloadSimulatorAsync(StorageFile)

Recharge le simulateur à l’aide d’un StorageFile contenant le fichier WindowsStoreProxy.xml.

Si vous n’appelez pas cette méthode pour charger votre propre fichier, le simulateur crée/charge (mais pas remplace) un fichier WindowsStoreProxy.xml contenant un ensemble de valeurs par défaut.
ReportConsumableFulfillmentAsync(String, Guid)

Simule la notification du Microsoft Store que l’achat d’un module complémentaire consommable (également appelé produit in-app ou IAP) est rempli et que l’utilisateur a le droit d’accéder au contenu.
RequestAppPurchaseAsync(Boolean)

Important

La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges.

Crée l’opération asynchrone qui simule une demande d’utilisateur pour acheter une licence complète pour l’application actuelle.
RequestProductPurchaseAsync(String, Boolean)

Important

La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges.

Note

[RequestProductPurchaseAsync(String, Boolean) peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt RequestProductPurchaseAsync(String).

Crée l’opération asynchrone qui affiche l’interface utilisateur utilisée pour simuler l’achat d’un module complémentaire (également appelé produit in-app ou IAP) à partir du Microsoft Store.
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

Important

La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges.

Crée l’opération asynchrone qui affiche l’interface utilisateur utilisée pour simuler l’achat d’un module complémentaire (également appelé produit in-app ou IAP) à partir du Microsoft Store. Cette surcharge inclut des paramètres que vous pouvez utiliser pour afficher les détails d’une offre spécifique dans un grand catalogue d’achats in-app représentés par une entrée de produit unique dans le Windows Store.
RequestProductPurchaseAsync(String)

Important

La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges.

Crée l’opération asynchrone qui affiche l’interface utilisateur utilisée pour simuler l’achat d’un module complémentaire (également appelé produit in-app ou IAP) à partir du Microsoft Store.

S’applique à

Voir aussi