Habilitar compras de produto no aplicativo (HTML)

Artigo
12/12/2015

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

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.

Observe que um cliente só poderá comprar um produto no aplicativo se tiver comprado a versão completa do seu aplicativo.

O que você precisa saber

Tecnologias

Windows Runtime
Windows.ApplicationModel.Store

Pré-requisitos

Um aplicativo do Tempo de Execução do Windows 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 compras de produto 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 o novo produto 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 %userprofile%\AppData\local\packages\<package name>\LocalState\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, consulte a documentação do CurrentAppSimulator.

Etapa 2: Adicione as ofertas de produto no aplicativo ao seu aplicativo

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

Importante Você deve adicionar todos os produtos no aplicativo que deseja apresentar para seus clientes antes de enviá-lo para a Loja. Para adicionar novos produtos no aplicativo depois, você deve atualizar o aplicativo e reenviar uma nova versão.

Crie um token de oferta no aplicativo

Você pode identificar cada produto no aplicativo em seu aplicativo por um token. Esse token é uma cadeia de caracteres que você define e usa no aplicativo e na Loja para identificar um produto no aplicativo específico. 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".
Codifique o recurso em um bloco de condições

Coloque o código de cada recurso associado a um produto 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 de produto chamado featureName em um bloco de condições específico da licença. A cadeia de caracteres, featureName, é o token que identifica esse produto de forma exclusiva no aplicativo e também é usada para identificá-lo na Loja.
```
if (licenseInformation.productLicenses.lookup("featureName").isActive) 
{
    // the customer can access this feature
}
else 
{
    // the customer can't access this feature
}
```

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 produto no aplicativo. O jeito de comprá-los é diferente da maneira como os clientes compraram o aplicativo completo na Loja.

Veja aqui como testar se o cliente já possui um produto 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 página com um botão "Compre este aplicativo!").

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: Configurar o produto no aplicativo na Loja

Antes de enviar o aplicativo para a Loja, adicione todos os produtos no aplicativo ao fluxo de trabalho Enviar um aplicativo. Aqui, você especifica o token, o preço e o tempo de vida de um produto no aplicativo. Lembre-se de configurá-lo com a mesma configuração que você definiu no WindowsStoreProxy.xml durante o teste.

Etapa 5: Descreva o produto no aplicativo na Loja

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

Redija uma descrição clara e específica, que informe com exatidão qual é o recurso que o produto no aplicativo agrega ao aplicativo. Se não tiver muito claro qual é o valor do produto 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 um produto no aplicativo, consulte Descrição do aplicativo.

Comentários

Se você tiver interesse em fornecer a seus clientes opções de produto no aplicativo consumível, continue com o tópico Habilitar compras de produto no aplicativo consumível.

Se você precisar usar recibos para verificar se o usuário comprou um produto no aplicativo, examine Usando recibos para verificar compras de produto.

Tópicos relacionados

Habilitar compras de produto no aplicativo consumível

Aplicativo de avaliação e exemplo de compra no aplicativo

Partilhar via