CurrentApp Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define métodos e propriedades que você pode usar para obter informações de licença e listagem sobre o aplicativo atual e realizar compras de produtos no aplicativo.
Observação
A classe CurrentApp e os outros tipos no namespace Windows.ApplicationModel.Store não estão mais sendo atualizados com novos recursos. Se o seu projeto se destina ao Windows 10 Anniversary Edition (10.0; Build 14393) ou uma versão posterior no Visual Studio (ou seja, você tem como destino o Windows 10, versão 1607 ou posterior), recomendamos que você use o namespace Windows.Services.Store. Para obter mais informações, consulte Compras no aplicativo e avaliações. Não há suporte para a classe CurrentApp em aplicativos da área de trabalho do Windows que usam o Ponte de Desktop ou em aplicativos ou jogos que usam uma área restrita de desenvolvimento no Partner Center (por exemplo, esse é o caso de qualquer jogo que se integre ao Xbox Live). Estes produtos devem usar o namespace Windows.Services.Store para implementar compras no aplicativo e avaliações.
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 CurrentAppPublic Class CurrentApp- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
Esse objeto obtém seus dados da Microsoft Store, portanto, você deve ter uma conta de desenvolvedor e o aplicativo deve ser publicado na Microsoft Store. Antes de enviar para a Microsoft Store, você pode testar seu código com uma versão simulada dessa classe (cujo estado é inicializado de um arquivo XML). Consulte CurrentAppSimulator.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1511 | 10586 | GetCustomerCollectionsIdAsync |
| 1511 | 10586 | GetCustomerPurchaseIdAsync |
Propriedades
| AppId |
Obtém o GUID gerado pela Windows Store quando seu aplicativo é certificado para listagem na Windows Store. Observação Depois que o aplicativo estiver na Windows Store, futuras atualizações ou alterações de aplicativo na descrição do aplicativo não resultarão em uma alteração no CurrentApp.AppId. |
| LicenseInformation |
Obtém os metadados de licença do aplicativo atual. |
| LinkUri |
Obtém o URI (Uniform Resource Identifier) da página de listagem do aplicativo no catálogo da Web da Windows Store. |
Métodos
| GetAppPurchaseCampaignIdAsync() |
Recupera a ID da campanha de promoção para o aplicativo atual. |
| GetAppReceiptAsync() |
Solicita todos os recibos para a compra do aplicativo e todos os produtos no aplicativo. Para obter exemplos de como as informações de recibo podem ser usadas, consulte Usando recibos para verificar compras de produtos. |
| GetCustomerCollectionsIdAsync(String, String) |
Recupera uma chave de ID da Microsoft Store que pode ser usada para consultar direitos de produto ou para consumir direitos de produto pertencentes ao usuário atual. |
| GetCustomerPurchaseIdAsync(String, String) |
Recupera uma chave de ID da Microsoft Store que pode ser usada para conceder direitos a produtos gratuitos em nome do usuário atual. |
| GetProductReceiptAsync(String) |
Solicita o recibo da ID do produto especificada. Para obter exemplos de como as informações de recibo podem ser usadas, consulte Usando recibos para verificar compras de produtos. |
| GetUnfulfilledConsumablesAsync() |
Retorna uma lista de produtos consumíveis adquiridos no aplicativo que não foram relatados à Microsoft Store conforme cumprido. |
| LoadListingInformationAsync() |
Carrega as informações de listagem do aplicativo de forma assíncrona. O objeto ListingInformation retornado contém informações de listagem (por exemplo, nome, preço, classificação etária) específicas para o mercado em que o usuário reside atualmente. Além disso, as informações de listagem para produtos disponíveis no aplicativo também são fornecidas. |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
Carrega as informações de listagem de aplicativo de forma assíncrona, retornando recursos e produtos na coleção ProductListings que correspondem a todas as palavras-chave fornecidas. |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
Carrega as informações de listagem de aplicativo de forma assíncrona, retornando recursos e produtos na coleção ProductListings que correspondem a qualquer uma das IDs de produtos fornecidas. |
| ReportConsumableFulfillmentAsync(String, Guid) |
Notifica a Microsoft Store de que a compra de um complemento consumível (também chamado de produto no aplicativo ou IAP) é atendida e que o usuário tem o direito de acessar o conteúdo. |
| ReportProductFulfillment(String) |
Notifica a Microsoft Store de que o aplicativo cumpriu o produto no aplicativo. Este produto não pode ser adquirido novamente até que o aplicativo confirme o cumprimento usando esse método. |
| RequestAppPurchaseAsync(Boolean) |
Solicita a compra de uma licença de aplicativo completa. |
| RequestProductPurchaseAsync(String) |
Solicita a compra de um complemento (também chamado de IAP ou produto no aplicativo). Além disso, chamar esse método exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store. |
| RequestProductPurchaseAsync(String, Boolean) |
Observação [RequestProductPurchaseAsync(String, Boolean) pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use RequestProductPurchaseAsync(String). Solicita a compra de um complemento (também chamado de IAP ou produto no aplicativo). Além disso, chamar esse método exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store. |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Solicita a compra de um complemento (também chamado de IAP ou produto no aplicativo). Além disso, chamar esse método exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store. Essa sobrecarga inclui parâmetros que você pode usar para exibir detalhes de uma oferta específica em um grande catálogo de compras no aplicativo representadas por uma única entrada de produto na Store. |