Habilitar compras no aplicativo em seu próprio aplicativo

Seu aplicativo pode oferecer produtos e recursos que os clientes podem comprar diretamente do aplicativo. Veja a seguir como habilitar essas ofertas em seu aplicativo.

Se você deseja trabalhar com as compras no aplicativo e outros dos principais recursos do Windows 8, baixe os laboratórios práticos do Windows 8. Com esses laboratórios, você terá uma introdução modular e passo a passo à criação de um exemplo de aplicativo da Windows Store na linguagem de programação que preferir (JavaScript e HTML ou C# e linguagem XAML).

Para ver como essa experiência aparece para o cliente, consulte A experiência de compra no aplicativo para um cliente. Lembre-se que um cliente pode fazer uma compra no aplicativo apenas se tiver adquirido a versão completa do seu aplicativo.

O que você precisa saber

Tecnologias

• Windows Runtime
• Windows.ApplicationModel.Store

Pré-requisitos

• Um aplicativo da Windows Store no qual devem ser adicionados os recursos que os clientes podem comprar.

Instruções

Etapa 1: Inicie as informações de licença do aplicativo

Quando seu aplicativo estiver inicializando, obtenha o objeto LicenseInformation para seu aplicativo inicializando o CurrentApp ou CurrentAppSimulator para habilitar as compras no aplicativo.

function appInit()
{
    // some app initialization functions

        // Get current product object 
        // Execute only one of these statements. 
        // The next line is commented out for testing.
        // currentApp = Windows.ApplicationModel.Store.CurrentApp;

        // The next line is commented out for production/release.
        currentApp = Windows.ApplicationModel.Store.CurrentAppSimulator;

        // We should have either a real or a simulated CurrentProduct object here.

        // Get the license info
        licenseInformation = currentApp.licenseInformation;

    // other app initializations function
}

Observação  Ao codificar e testar novas ofertas no aplicativo pela primeira vez, use o objeto CurrentAppSimulator em vez do objeto CurrentApp. Dessa forma, é possível verificar a lógica do licenciamento usando chamadas simuladas ao servidor de licenças em vez de chamar o servidor ativo. Para isso, você precisa personalizar o arquivo chamado “WindowsStoreProxy.xml” em <installation_folder>\Microsoft\Windows Store\ApiData. O simulador do Microsoft Visual Studio cria esse arquivo quando você executa seu aplicativo pela primeira vez, mas também é possível carregar um arquivo personalizado no tempo de execução. Para saber mais, veja a documentação do CurrentAppSimulator.

Etapa 2: Adicione as ofertas no aplicativo

Para cada recurso a ser disponibilizado por meio de uma transação de compra no aplicativo, crie uma oferta no aplicativo e adicione-a ao aplicativo.

Importante  Você deve adicionar ao aplicativo todas as ofertas no aplicativo que deseja apresentar para seus clientes antes de enviá-lo para a Windows Store. Para adicionar novas ofertas no aplicativo depois, você deve atualizar o aplicativo e enviar uma nova versão para a Windows Store.

1. Crie um token de oferta no aplicativo

   Você pode identificar cada oferta no aplicativo por um token de oferta no aplicativo. Esse token é uma cadeia de caracteres que você define e usa no aplicativo e na Windows Store para identificar uma oferta no aplicativo específica. Dê (ao aplicativo) um nome exclusivo e significativo, para poder identificar o recurso correto que ele representa durante a codificação. Este são alguns exemplos de nomes:

   • "SpaceMissionLevel4"
   • "ContosoCloudSave"
   • "RainbowThemePack".

2. Codifique o recurso em um bloco de condições

   Coloque o código de cada recurso associado a uma oferta no aplicativo em um bloco de condições que testa se o cliente tem uma licença para usar esse recurso.

   Veja um exemplo que mostra como é possível codificar um recurso chamado featureName em um bloco de condições específico da licença. A cadeia de caracteres featureName é o token que identifica esse recurso de forma exclusiva no aplicativo e também é usada para identificá-lo na Windows Store.

   JavaScript

   C#

   Copiar

   
   
   if (licenseInformation.productLicenses.lookup("featureName").isActive) 
   {
       // the customer can access this feature
   }
   else 
   {
       // the customer can't access this feature
   }
   
   
   

3. Adicione a interface do usuário de compra para este recurso

   Seu aplicativo também deve permitir que os clientes comprem o produto ou o recurso proposto para oferta no aplicativo. O jeito de comprá-los é diferente da maneira como os clientes compraram o aplicativo completo na Windows Store.

   Veja aqui como testar se o cliente já possui uma oferta no aplicativo e, se não tiver, se ele pode visualizar a caixa de diálogo para fazer a compra. Substitua o comentário "mostrar a caixa de diálogo de compra" pelo código personalizado da caixa de diálogo de compra (como uma janela com um botão "Compre este aplicativo!").

   JavaScript

   C#

   Copiar

   
   function buyFeature1() {
       if (!licenseInformation.productLicenses.lookup("featureName").isActive)
       {
           // The customer doesn't own this feature, so 
           // show the purchase dialog.
   								
           // note: currentApp is a reference to CurrentAppSimulator from a previous declaration
           currentApp.requestProductPurchaseAsync("featureName", false).then(
               function () {
                   //Check the license state to determine if the in-app purchase was successful.
               }, 
               function () {
                   // The in-app purchase was not completed because 
                   // there was an error.
               });
       } 
       else
       {
           // The customer already owns this feature.
       }
   }
   
   

Etapa 3: Mude o código de teste para as chamadas finais

Esta etapa é fácil: basta mudar todas as referências de CurrentAppSimulator para CurrentApp no código do aplicativo. Não é mais preciso fornecer o arquivo WindowsStoreProxy.xml, então, remova-o do caminho do aplicativo (embora você possa salvá-lo para referência ao configurar a oferta no aplicativo, na próxima etapa).

Etapa 4: Configure a oferta no aplicativo na Windows Store

Antes de enviar o aplicativo para a loja, adicione todas as ofertas no aplicativo à página Recursos avançados no fluxo de trabalho Enviar um aplicativo. Aqui, você especifica o token, o preço e o tempo de vida do recurso da oferta no aplicativo. Certifique-se de configurá-lo da mesma forma definida em WindowsStoreProxy.xml durante os testes, ou todo o trabalho de teste será perdido!

Etapa 5: Descreva a oferta no aplicativo na Windows Store

Depois de carregar o pacote do aplicativo na loja, você pode colocar a descrição de cada oferta no aplicativo na página Descrição ao enviar o aplicativo. Se o aplicativo for compatível com mais de um idioma, descreva cada oferta no aplicativo em todos os idiomas compatíveis.

Redija uma descrição clara e específica, que informe com exatidão o que o recurso agrega ao aplicativo. Se não tiver muito claro qual é o valor do recurso que vai além daquilo que o próprio aplicativo fornece, será difícil vendê-lo. Para saber de mais detalhes sobre partes específicas da descrição de uma compra no aplicativo, veja Descrição do aplicativo.

Comentários

Se você precisar usar recibos para verificar se o usuário fez uma compra no aplicativo, veja Verificando compras usando recibos.