Condividi tramite


CurrentApp Classe

Definizione

Definisce i metodi e le proprietà che è possibile usare per ottenere le informazioni sulle licenze e elencare l'app corrente ed eseguire acquisti di prodotti in-app.

Nota

La classe CurrentApp 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 CurrentApp 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 CurrentApp 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 CurrentApp 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 CurrentApp
Public Class CurrentApp
Ereditarietà
Object Platform::Object IInspectable CurrentApp
Attributi

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

Questo oggetto ottiene i dati da Microsoft Store, quindi è necessario disporre di un account sviluppatore e l'app deve essere pubblicata in Microsoft Store. Prima di inviare a Microsoft Store, è possibile testare il codice con una versione simulata di questa classe (lo stato viene inizializzato da un file XML). Vedere CurrentAppSimulator.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1511 10586 GetCustomerCollectionsIdAsync
1511 10586 GetCustomerPurchaseIdAsync

Proprietà

AppId

Ottiene il GUID generato da Windows Store quando l'app è stata certificata per la presentazione in Windows Store.

Nota

Dopo che l'app si trova in Windows Store, gli aggiornamenti delle app future o le modifiche apportate alla descrizione dell'app non generano una modifica all'oggetto CurrentApp.AppId.

LicenseInformation

Ottiene i metadati della licenza per l'app corrente.

LinkUri

Ottiene l'URI (Uniform Resource Identifier) della pagina di presentazione dell'app nel catalogo Web di Windows Store.

Metodi

GetAppPurchaseCampaignIdAsync()

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

GetAppReceiptAsync()

Richiede tutte le ricevute per l'acquisto dell'app e di tutti i prodotti in-app. Per esempi di come è possibile usare le informazioni sulla ricezione, vedere Uso delle ricevute per verificare gli acquisti di prodotti.

GetCustomerCollectionsIdAsync(String, String)

Recupera una chiave ID di Microsoft Store che può essere usata per eseguire query sui diritti del prodotto o per l'utilizzo dei diritti del prodotto di proprietà dell'utente corrente.

GetCustomerPurchaseIdAsync(String, String)

Recupera una chiave ID di Microsoft Store che può essere usata per concedere i diritti per i prodotti gratuiti per conto dell'utente corrente.

GetProductReceiptAsync(String)

Richiede la 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 segnalati a Microsoft Store come soddisfatti.

LoadListingInformationAsync()

Carica le informazioni sulla presentazione dell'app 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 le informazioni sulla presentazione per i prodotti in-app disponibili.

LoadListingInformationByKeywordsAsync(IIterable<String>)

Carica le informazioni sull'elenco delle app in modo asincrono, restituendo funzionalità e prodotti nella raccolta ProductListings che corrispondono a tutte le parole chiave fornite.

LoadListingInformationByProductIdsAsync(IIterable<String>)

Carica le informazioni sull'elenco delle app in modo asincrono, restituendo funzionalità e prodotti nella raccolta ProductListings che corrispondono a uno qualsiasi degli ID prodotti specificati.

ReportConsumableFulfillmentAsync(String, Guid)

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.

ReportProductFulfillment(String)

Notifica a Microsoft Store che l'applicazione ha soddisfatto il prodotto in-app. Questo prodotto non può essere acquistato nuovamente fino a quando l'app non ha confermato l'adempimento usando questo metodo.

RequestAppPurchaseAsync(Boolean)

Richiede l'acquisto di una licenza di app completa.

RequestProductPurchaseAsync(String)

Richiede l'acquisto di un componente aggiuntivo (chiamato anche prodotto in-app o IAP). Inoltre, la chiamata a questo metodo visualizza l'interfaccia utente usata per completare la transazione tramite 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).

Richiede l'acquisto di un componente aggiuntivo (chiamato anche prodotto in-app o IAP). Inoltre, la chiamata a questo metodo visualizza l'interfaccia utente usata per completare la transazione tramite Microsoft Store.

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

Richiede l'acquisto di un componente aggiuntivo (chiamato anche prodotto in-app o IAP). Inoltre, la chiamata a questo metodo visualizza l'interfaccia utente usata per completare la transazione tramite 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

Vedi anche