CurrentAppSimulator Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.ApplicationModel.Store

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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

Nota

La classe CurrentAppSimulator e gli altri tipi nello spazio dei nomi Windows.ApplicationModel.Store non vengono più aggiornati con nuove funzionalità. Se il progetto è destinato Windows 10 Anniversary Edition (10,0; Build 14393) o una versione successiva in Visual Studio (ovvero, si intende indirizzare Windows 10, versione 1607 o successiva), è consigliabile usare invece lo spazio dei nomi Windows.Services.Store. Per altre informazioni, vedi Acquisti in-app e versioni di prova. La classe CurrentAppSimulator non è supportata nelle applicazioni desktop di Windows che usano la Desktop Bridge o nelle app o nei giochi che usano una sandbox di sviluppo nel 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 e versioni di valutazione in-app.

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

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. Usare CurrentAppSimulator per testare le licenze e i prodotti in-app dell'app durante lo sviluppo dell'app. Dopo aver testato l'app e prima di inviarla a Microsoft Store, è necessario sostituire le istanze di CurrentAppSimulator con CurrentAppSimulator. Usando CurrentAppSimulator, l'app non supererà la certificazione.

Quando viene usato CurrentAppSimulator, lo stato iniziale delle licenze dell'app viene descritto in un file denominato WindowsStoreProxy.xml. 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 riavviata, viene ripristinato lo stato della licenza indicato in WindowsStoreProxy.xml.

Per altre informazioni sul file WindowsStoreProxy.xml, vedere Uso del file WindowsStoreProxy.xml con CurrentAppSimulator.

Proprietà

AppId

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

Dopo che l'app è elencata in Windows Store, CurrentApp.AppId otterrà il GUID generato durante l'imbarco dell'app e usato per elencare l'app all'interno del catalogo di Windows Store.

Nota

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

LicenseInformation

Ottiene i metadati delle licenze 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

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 gli acquisti di prodotti in-app. Per esempi di come è possibile usare le informazioni sulla ricezione, 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 ricezione, 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 in locale.
LoadListingInformationAsync()	Carica le informazioni sull'elenco di app simulate in modo asincrono. L'oggetto ListingInformation restituito contiene informazioni sull'elenco (ad esempio, nome, prezzo, classificazione dell'età) specifiche per il mercato in cui risiede attualmente l'utente. Vengono inoltre fornite informazioni sulla presentazione dei prodotti disponibili tramite prodotti in-app. Nota A scopo di simulazione, questo metodo usa l'elemento nel file WindowsStoreProxy.xml come origine dati per i membri dell'oggetto restituito. Per altre informazioni, vedere gli esempi di codice in CurrentAppSimulator.
LoadListingInformationByKeywordsAsync(IIterable<String>)	Carica le informazioni sull'elenco di app simulate in modo asincrono, restituendo prodotti in-app nella raccolta ProductListings che corrispondono a tutte le parole chiave fornite.
LoadListingInformationByProductIdsAsync(IIterable<String>)	Carica le informazioni sull'elenco di app simulate in modo asincrono, restituendo prodotti in-app disponibili nella raccolta ProductListings che corrispondono a uno degli ID prodotti specificati.
ReloadSimulatorAsync(StorageFile)	Ricarica il simulatore usando un File di archiviazione contenente il file diWindowsStoreProxy.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 (chiamato anche prodotto in-app o IAP) viene soddisfatto e che l'utente ha il diritto di accedere al contenuto.
RequestAppPurchaseAsync(Boolean)	Crea l'operazione asincrona che simula una richiesta utente per acquistare una licenza completa per l'app corrente.
RequestProductPurchaseAsync(String)	Crea l'operazione asincrona che visualizza l'interfaccia utente usata per simulare l'acquisto di un componente aggiuntivo (denominato anche prodotto in-app o IAP) da Microsoft Store.
RequestProductPurchaseAsync(String, Boolean)	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 (denominato anche prodotto in-app o IAP) da Microsoft Store.
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)	Crea l'operazione asincrona che visualizza l'interfaccia utente usata per simulare l'acquisto di un componente aggiuntivo (denominato 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 catalogo elevato di acquisti in-app rappresentati da una singola voce del prodotto nello Store.

Si applica a