CurrentAppSimulator Classe

Definizione

Definisce metodi e proprietà usati per creare un'istanza di un oggetto che è possibile usare per ottenere informazioni sulle licenze simulate durante il test.

Nota

La classe CurrentAppSimulator e gli altri tipi nello spazio dei nomi Windows.ApplicationModel.Store non vengono più aggiornati con le nuove funzionalità. Se il progetto è destinato Edizione dell'anniversario di Windows 10 (10.0; Build 14393) o una versione successiva in Visual Studio (ovvero hai come destinazione Windows 10, versione 1607 o successiva), ti consigliamo di usare invece lo spazio dei nomi Windows.Services.Store. Per altre informazioni, vedere acquisti in-app e versioni di valutazione. La classe CurrentAppSimulator non è supportata nelle applicazioni desktop di Windows che usano il Desktop Bridge o nelle app o nei giochi che usano una sandbox di sviluppo in Centro per i partner (ad esempio, questo è il caso di qualsiasi gioco che si integra con Xbox Live). Questi prodotti devono usare lo spazio dei nomi Windows.Services.Store per implementare acquisti in-app e versioni di valutazione.

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
Ereditarietà
Object Platform::Object IInspectable CurrentAppSimulator
Attributi

Requisiti Windows

Requisiti Descrizione
Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Fino a quando l'app non è stata elencata in Microsoft Store, l'oggetto CurrentApp non funzionerà nell'app. Usa CurrentAppSimulator per testare le licenze e i prodotti in-app della tua app durante lo sviluppo dell'app. Dopo aver testato l'app e prima di inviarla a Microsoft Store, devi sostituire le istanze di CurrentAppSimulator con CurrentApp. Se usa CurrentAppSimulator, l'app avrà esito negativo.

Quando viene usato CurrentAppSimulator, lo stato di licenza iniziale dell'app viene descritto in un file denominato WindowsStoreProxy.xml. I metodi CurrentAppSimulator che modificano lo stato della licenza, ad esempio acquistando una licenza o gestendo un acquisto in-app, aggiornano solo lo stato della licenza dell'oggetto in memoria. Il contenuto di WindowsStoreProxy.xml non viene modificato. Quando l'app viene avviata di nuovo, lo stato della licenza torna a quello descritto in WindowsStoreProxy.xml.

Per altre informazioni sul file di WindowsStoreProxy.xml, vedere Using the WindowsStoreProxy.xml file with CurrentAppSimulator.

Proprietà

Nome Descrizione
AppId

Ottiene un ID app simulato. Poiché CurrentAppSimulator è destinato solo ai test durante lo sviluppo di app, currentAppSimulator.AppId restituito conterrà solo 0.

Una volta elencata l'app in Windows Store, CurrentApp.AppId otterrà il GUID generato durante l'onboarding dell'app e usato per elencare l'app all'interno del catalogo di Windows Store.

Nota

Gli aggiornamenti delle app o le modifiche apportate alla descrizione dell'app non comportano una modifica alla CurrentApp.AppId.

LicenseInformation

Ottiene i metadati di licenza simulati per l'app corrente, come fornito dalla simulazione.

LinkUri

Ottiene l'URI (Uniform Resource Identifier) simulato che rappresenta una pagina di presentazione di Microsoft Store per l'app corrente.

Metodi

Nome Descrizione
GetAppPurchaseCampaignIdAsync()

Recupera l'ID campagna promozionale per l'app corrente.

GetAppReceiptAsync()

Crea l'operazione asincrona che l'utente può usare per simulare la richiesta di tutte le ricevute per questa app e qualsiasi acquisto di prodotti in-app. Per esempi di come è possibile usare le informazioni sulla ricevuta, vedere Uso delle ricevute per verificare gli acquisti di prodotti.

GetProductReceiptAsync(String)

Crea l'operazione asincrona che l'utente può usare per simulare la richiesta della ricevuta per l'ID prodotto specificato. Per esempi di come è possibile usare le informazioni sulla ricevuta, vedere Uso delle ricevute per verificare gli acquisti di prodotti.

GetUnfulfilledConsumablesAsync()

Restituisce un elenco di prodotti di consumo acquistati in-app che non sono stati soddisfatti localmente.

LoadListingInformationAsync()

Carica in modo asincrono le informazioni di presentazione dell'app simulata.

L'oggetto ListingInformation restituito contiene informazioni sull'inserzione (ad esempio, nome, prezzo, fascia d'età) specifiche del mercato in cui risiede attualmente l'utente. Vengono inoltre fornite informazioni di presentazione per i prodotti disponibili tramite prodotti in-app.

Nota

Ai fini della simulazione, questo metodo usa l'elemento nel file WindowsStoreProxy.xml come origine dati per i membri dell'oggetto restituito. Per altre info, vedi gli esempi di codice in CurrentAppSimulator.

LoadListingInformationByKeywordsAsync(IIterable<String>)

Carica in modo asincrono le informazioni sull'elenco di app simulate, restituendo prodotti in-app nella raccolta ProductListings che corrispondono a tutte le parole chiave fornite.

LoadListingInformationByProductIdsAsync(IIterable<String>)

Carica le informazioni di presentazione delle app simulate in modo asincrono, restituendo i prodotti in-app disponibili nella raccolta ProductListings che corrispondono a uno qualsiasi degli ID prodotti specificati.

ReloadSimulatorAsync(StorageFile)

Ricarica il simulatore usando un StorageFile contenente il file WindowsStoreProxy.xml.

Se non si chiama questo metodo per caricare il proprio file, il simulatore creerà/caricherà (ma non sovrascrive) un file WindowsStoreProxy.xml contenente un set di valori predefiniti.

ReportConsumableFulfillmentAsync(String, Guid)

Simula la notifica a Microsoft Store che l'acquisto di un componente aggiuntivo di consumo (detto anche prodotto in-app o IAP) viene soddisfatto e che l'utente ha il diritto di accedere al contenuto.

RequestAppPurchaseAsync(Boolean)

Importante

La funzionalità di acquisto in-app non è supportata nelle applicazioni con privilegi elevati.

Crea l'operazione asincrona che simula una richiesta utente di acquistare una licenza completa per l'app corrente.

RequestProductPurchaseAsync(String, Boolean)

Importante

La funzionalità di acquisto in-app non è supportata nelle applicazioni con privilegi elevati.

Nota

[RequestProductPurchaseAsync(String, Boolean) può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece RequestProductPurchaseAsync(String).

Crea l'operazione asincrona che visualizza l'interfaccia utente usata per simulare l'acquisto di un componente aggiuntivo (detto anche prodotto in-app o IAP) da Microsoft Store.

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

Importante

La funzionalità di acquisto in-app non è supportata nelle applicazioni con privilegi elevati.

Crea l'operazione asincrona che visualizza l'interfaccia utente usata per simulare l'acquisto di un componente aggiuntivo (detto anche prodotto in-app o IAP) da Microsoft Store. Questo overload include parametri che è possibile usare per visualizzare i dettagli per un'offerta specifica all'interno di un ampio catalogo di acquisti in-app rappresentati da una singola voce di prodotto nello Store.

RequestProductPurchaseAsync(String)

Importante

La funzionalità di acquisto in-app non è supportata nelle applicazioni con privilegi elevati.

Crea l'operazione asincrona che visualizza l'interfaccia utente usata per simulare l'acquisto di un componente aggiuntivo (detto anche prodotto in-app o IAP) da Microsoft Store.

Si applica a

Vedi anche