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.
Nota
A classe CurrentApp e os outros tipos no namespace Windows.ApplicationModel.Store não estão mais sendo atualizados com novos recursos. Se o projeto for direcionado Edição de Aniversário do Windows 10 (10.0; Build 14393) ou uma versão posterior no Visual Studio (ou seja, você está direcionando o Windows 10, versão 1607 ou posterior), recomendamos que você use o namespace Windows.Services.Store. Para obter mais informações, consulte de compras e avaliações no aplicativo. A classe
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
| Requisitos | Description |
|---|---|
| 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ões
| Versão do Windows | Versão do SDK | Valor acrescentado |
|---|---|---|
| 1511 | 10586 | GetCustomerCollectionsIdAsync |
| 1511 | 10586 | GetCustomerPurchaseIdAsync |
Propriedades
| Nome | Description |
|---|---|
| AppId |
Obtém o GUID gerado pela Windows Store quando seu aplicativo foi certificado para listagem na Windows Store. Nota Depois que seu aplicativo estiver na Windows Store, futuras atualizações de aplicativo ou alterações 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
| Nome | Description |
|---|---|
| GetAppPurchaseCampaignIdAsync() |
Recupera a ID da campanha de promoção para o aplicativo atual. |
| GetAppReceiptAsync() |
Solicita todos os recibos para a compra do aplicativo e quaisquer produtos no aplicativo. Para obter exemplos de como as informações de recebimento podem ser usadas, consulte Usando recibos para verificar as compras de produtos. |
| GetCustomerCollectionsIdAsync(String, String) |
Recupera uma chave de ID da Microsoft Store que pode ser usada para consultar direitos de produto ou consumir direitos de produto que pertencem ao usuário atual. |
| GetCustomerPurchaseIdAsync(String, String) |
Recupera uma chave de ID da Microsoft Store que pode ser usada para conceder direitos para 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 recebimento podem ser usadas, consulte Usando recibos para verificar as compras de produtos. |
| GetUnfulfilledConsumablesAsync() |
Retorna uma lista de produtos consumíveis comprados no aplicativo que não foram relatados à Microsoft Store conforme atendido. |
| 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 aplicativos de forma assíncrona, retornando recursos e produtos no ProductListings coleção que correspondem a todas as palavras-chave fornecidas. |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
Carrega as informações de listagem de aplicativos de forma assíncrona, retornando recursos e produtos no ProductListings coleção 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 comprado novamente até que o aplicativo confirme o cumprimento usando esse método. |
| RequestAppPurchaseAsync(Boolean) |
Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados. Solicita a compra de uma licença de aplicativo completa. |
| RequestProductPurchaseAsync(String, Boolean) |
Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados. Nota [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) |
Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados. 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 catálogo grande de compras no aplicativo representadas por uma única entrada de produto na Loja. |
| RequestProductPurchaseAsync(String) |
Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados. 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. |
Aplica-se a
Confira também
- de exemplo do Repositório de
() - exemplo de compra do aplicativo de avaliação e no aplicativo ()