Compartilhar via


CurrentApp Classe

Definição

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 CurrentApp
Public Class CurrentApp
Herança
Object Platform::Object IInspectable CurrentApp
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.

Aplica-se a

Confira também