CurrentAppSimulator 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 usados para instanciar um objeto que você pode usar para obter informações de licença simuladas durante o teste.
Observação
A classe CurrentAppSimulator 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 CurrentAppSimulator 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 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 CurrentAppSimulatorPublic Class CurrentAppSimulator- 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
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 o app e antes de enviá-lo para a Microsoft Store, você deve substituir as instâncias de CurrentAppSimulator por CurrentApp. O app será reprovado na certificação se ele 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 app é iniciado novamente, o estado da licença é revertido para o que está descrito no WindowsStoreProxy.xml.
Para obter mais informações sobre o arquivo WindowsStoreProxy.xml, consulte Usando o arquivo WindowsStoreProxy.xml com CurrentAppSimulator.
Propriedades
| AppId |
Obtém uma ID simulada do aplicativo. Como CurrentAppSimulator destina-se apenas a testes durante o desenvolvimento de aplicativos, o CurrentAppSimulator.AppId retornado conterá apenas 0's. Depois que seu aplicativo estiver listado na Windows Store, CurrentApp.AppId obterá o GUID gerado durante o embarque do aplicativo e será usado para listar seu aplicativo no catálogo da Windows Store. Observação 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 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
| 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 quaisquer compras de produto no aplicativo. Para obter exemplos de como as informações de recibo podem ser usadas, consulte Usando recibos para verificar 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 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 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, a listagem de informações para produtos disponíveis por meio de produtos no aplicativo também é fornecida. Observação 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 de listagem de aplicativos simulados 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 de listagem de aplicativos simulados de forma assíncrona, retornando produtos disponíveis no aplicativo na coleção ProductListings 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 a notificação da 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) |
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) |
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 produto no aplicativo ou IAP) 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). 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 produto no aplicativo ou IAP) da Microsoft Store. |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
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 produto no aplicativo ou IAP) 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. |