CurrentAppSimulator Classe

Definição

Namespace:: Windows.ApplicationModel.Store

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.

Editar

Define métodos e propriedades usados para criar uma instância de um objeto que você pode usar para obter informações de licença simuladas durante o teste.

Nota

A classe CurrentAppSimulator 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 CurrentAppSimulator não tem suporte em aplicativos da área de trabalho do Windows que usam o da Ponte da Área de Trabalho 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). Esses produtos devem usar o namespace Windows.Services.Store para implementar compras e avaliações no aplicativo.

public ref class CurrentAppSimulator 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 CurrentAppSimulator 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 CurrentAppSimulator

Public Class CurrentAppSimulator

Herança: Object Platform::Object IInspectable CurrentAppSimulator

Atributos: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Até que o aplicativo tenha sido listado na Microsoft Store, o objeto CurrentApp não funcionará no aplicativo. Use o CurrentAppSimulator para testar o licenciamento do aplicativo e os produtos no aplicativo enquanto você desenvolve seu aplicativo. Depois de testar seu aplicativo e antes de enviá-lo para a Microsoft Store, você deve substituir as instâncias do CurrentAppSimulator por CurrentApp. Seu aplicativo falhará na certificação se usar CurrentAppSimulator.

Quando o CurrentAppSimulator é usado, o estado de licenciamento inicial do aplicativo é descrito em um arquivo chamado WindowsStoreProxy.xml. Os métodos CurrentAppSimulator que alteram o estado da licença, por exemplo, comprando uma licença ou tratando uma compra no aplicativo, atualizam apenas o estado de licença do objeto na memória. O conteúdo de WindowsStoreProxy.xml não é alterado. Quando o aplicativo é iniciado novamente, o estado da licença é revertido para o que é descrito em WindowsStoreProxy.xml.

Para obter mais informações sobre o arquivo WindowsStoreProxy.xml, consulte Usando o arquivo WindowsStoreProxy.xml com CurrentAppSimulator.

Propriedades

Nome	Description
AppId	Obtém uma ID do aplicativo simulado. Como CurrentAppSimulator destina-se apenas a testes durante o desenvolvimento do aplicativo, o CurrentAppSimulator.AppId retornado conterá apenas 0. Depois que seu aplicativo estiver listado na Windows Store, CurrentApp.AppId obterá o guid gerado durante o carregamento do aplicativo e usado para listar seu aplicativo no catálogo da Windows Store. Nota Atualizações ou alterações de aplicativo na descrição do aplicativo não resultarão em uma alteração noCurrentApp.AppId.
LicenseInformation	Obtém os metadados de licença simulados para o aplicativo atual, conforme fornecido pela simulação.
LinkUri	Obtém o URI (Uniform Resource Identifier) simulado que representa uma página de listagem da Microsoft Store para o aplicativo atual.

Nome

Description

AppId

Obtém uma ID do aplicativo simulado. Como CurrentAppSimulator destina-se apenas a testes durante o desenvolvimento do aplicativo, o CurrentAppSimulator.AppId retornado conterá apenas 0.

Depois que seu aplicativo estiver listado na Windows Store, CurrentApp.AppId obterá o guid gerado durante o carregamento do aplicativo e usado para listar seu aplicativo no catálogo da Windows Store.

Nota

Atualizações ou alterações de aplicativo na descrição do aplicativo não resultarão em uma alteração noCurrentApp.AppId.

LicenseInformation

Obtém os metadados de licença simulados para o aplicativo atual, conforme fornecido pela simulação.

LinkUri

Obtém o URI (Uniform Resource Identifier) simulado que representa uma página de listagem da Microsoft Store para o aplicativo atual.

Métodos

Nome	Description
GetAppPurchaseCampaignIdAsync()	Recupera a ID da campanha de promoção para o aplicativo atual.
GetAppReceiptAsync()	Cria a operação assíncrona que o usuário pode usar para simular a solicitação de todos os recibos para este aplicativo e qualquer compra de produto no aplicativo. Para obter exemplos de como as informações de recebimento podem ser usadas, consulte Usando recibos para verificar as compras de produtos.
GetProductReceiptAsync(String)	Cria a operação assíncrona que o usuário pode usar para simular a solicitação do 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 atendidos localmente.
LoadListingInformationAsync()	Carrega as informações de listagem de aplicativos simulados 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 de produtos disponíveis por meio de produtos no aplicativo também são fornecidas. Nota Para fins de simulação, esse método usa o elemento no arquivo WindowsStoreProxy.xml como a fonte de dados para os membros do objeto retornado. Para obter mais informações, consulte os exemplos de código em CurrentAppSimulator.
LoadListingInformationByKeywordsAsync(IIterable<String>)	Carrega as informações simuladas de listagem de aplicativos de forma assíncrona, retornando produtos no aplicativo na coleção ProductListings que correspondem a todas as palavras-chave fornecidas.
LoadListingInformationByProductIdsAsync(IIterable<String>)	Carrega as informações simuladas de listagem de aplicativos de forma assíncrona, retornando produtos disponíveis no aplicativo no ProductListings coleção que correspondem a qualquer uma das IDs de produtos fornecidas.
ReloadSimulatorAsync(StorageFile)	Recarrega o simulador usando um StorageFile que contém o arquivo WindowsStoreProxy.xml. Se você não chamar esse método para carregar seu próprio arquivo, o simulador criará/carregará (mas não substituirá) um arquivo WindowsStoreProxy.xml que contém um conjunto de valores padrão.
ReportConsumableFulfillmentAsync(String, Guid)	Simula notificar 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.
RequestAppPurchaseAsync(Boolean)	Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados. Cria a operação assíncrona que simula uma solicitação de usuário para comprar uma licença completa para o aplicativo atual.
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). Cria a operação assíncrona que exibe a interface do usuário usada para simular a compra de um complemento (também chamado de IAP ou produto no aplicativo) 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. Cria a operação assíncrona que exibe a interface do usuário usada para simular a compra de um complemento (também chamado de IAP ou produto no aplicativo) 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. Cria a operação assíncrona que exibe a interface do usuário usada para simular a compra de um complemento (também chamado de IAP ou produto no aplicativo) 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 ()

Comentários

Esta página foi útil?