CurrentApp Classe

Definizione

Definisce metodi e proprietà che puoi usare per ottenere informazioni sulla licenza 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 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 CurrentApp 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 Partner Center (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 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

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

Questo oggetto ottiene i dati da Microsoft Store, quindi devi avere un account per 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 (il cui 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à

Nome Descrizione
AppId

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

Nota

Una volta che l'app si trova in Windows Store, gli aggiornamenti futuri delle app o le modifiche apportate alla descrizione dell'app non genereranno una modifica a 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

Nome Descrizione
GetAppPurchaseCampaignIdAsync()

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

GetAppReceiptAsync()

Richiede tutte le ricevute per l'acquisto dell'app e dei prodotti in-app. Per esempi di come è possibile usare le informazioni sulla ricevuta, 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 utilizzare i diritti del prodotto di proprietà dell'utente corrente.

GetCustomerPurchaseIdAsync(String, String)

Recupera una chiave ID di Microsoft Store che può essere usata per concedere 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 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 segnalati a Microsoft Store come soddisfatti.

LoadListingInformationAsync()

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

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

LoadListingInformationByKeywordsAsync(IIterable<String>)

Carica le informazioni di presentazione dell'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 di presentazione dell'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 (detto 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'evasione usando questo metodo.

RequestAppPurchaseAsync(Boolean)

Importante

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

Richiede l'acquisto di una licenza completa dell'app.

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).

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

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

Importante

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

Richiede l'acquisto di un componente aggiuntivo (detto anche prodotto in-app o IAP). Inoltre, chiamando questo metodo viene visualizzata 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 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.

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

Si applica a

Vedi anche