CurrentAppSimulator Classe

Référence

Définition

Espace de noms:: Windows.ApplicationModel.Store

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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

Notes

La classe CurrentAppSimulator 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 Windows 10 édition anniversaire (10.0 ; Build 14393) ou 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 Versions d’évaluation et achats in-app. La classe CurrentAppSimulator n’est pas prise en charge dans les applications de bureau Windows qui utilisent le Pont du bureau ou dans les applications ou jeux qui utilisent un bac à sable de développement dans l’Espace partenaires (par exemple, c’est le 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 essais 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

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 fonctionne 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 ne sera pas certifiée 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. Les 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 uniquement à jour l’état de licence de l’objet en mémoire. Le contenu du fichier WindowsStoreProxy.xml n’est pas modifié. Au redémarrage de l’application, la licence reprend l’état décrit dans le fichier WindowsStoreProxy.xml.

Pour plus d’informations sur le fichier WindowsStoreProxy.xml, consultez Utilisation du fichier WindowsStoreProxy.xml avec CurrentAppSimulator.

Propriétés

AppId

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

Une fois votre application répertoriée dans le Windows Store, CurrentApp.AppId obtient 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.

Notes

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

LicenseInformation

Obtient les métadonnées de licence simulées pour l’application actuelle, telles que fournies par la simulation.

LinkUri

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

Méthodes

GetAppPurchaseCampaignIdAsync()	Récupère l’ID de campagne de promotion pour 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 de 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 de reçus pour vérifier les achats de produits.
GetUnfulfilledConsumablesAsync()	Retourne une liste des produits consommables achetés dans l’application qui n’ont pas été exécutés localement.
LoadListingInformationAsync()	Charge de façon asynchrone les informations de liste des applications simulées. L’objet ListingInformation retourné contient des informations de référencement (par exemple, nom, prix, âge) spécifiques au marché dans lequel l’utilisateur réside actuellement. En outre, des informations de référencement pour les produits disponibles via les produits dans l’application sont également fournies. Notes À des fins de simulation, cette méthode utilise l’élément dans le 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 de façon asynchrone les informations de référencement des applications simulées, en retournant les produits dans l’application dans la collection ProductListings qui correspondent à tous les mots clés fournis.
LoadListingInformationByProductIdsAsync(IIterable<String>)	Charge de manière asynchrone les informations de liste d’applications simulées, en retournant les produits in-app disponibles dans la collection ProductListings 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 ne remplace pas) un fichier WindowsStoreProxy.xml contenant un ensemble de valeurs par défaut.
ReportConsumableFulfillmentAsync(String, Guid)	Simule la notification au Microsoft Store que l’achat d’un module complémentaire consommable (également appelé produit in-app ou IAP) est effectué et que l’utilisateur a le droit d’accéder au contenu.
RequestAppPurchaseAsync(Boolean)	Crée l’opération asynchrone qui simule une demande d’achat d’une licence complète pour l’application actuelle.
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, Boolean)	Notes [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)	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 qui est représenté par une seule entrée de produit dans le Windows Store.

S’applique à