Pular para o conteúdo principal

Introdução ao PlayFab (Legacy Economy), Unity IAP e Android

As APIs do Economy v1 estão em modo de manutenção e não receberão novos recursos, apenas correções de bugs. As APIs v1 serão mantidas no futuro próximo. Consulte a Visão geral do Economy v2 para saber mais sobre a próxima versão do PlayFab Economy!
Este tutorial mostra como configurar compras no aplicativo (IAP) usando o PlayFab, o serviço Unity + IAP e a Android Billing API.

Antes de começar

Configurar IAP pode ser trabalhoso, especialmente se você não tiver certeza de como os diferentes serviços devem se integrar e cooperar. A imagem a seguir ilustra como a Android Billing API e o PlayFab funcionam juntos para fornecer uma experiência de IAP sólida para o seu cliente. Android Billing - PlayFab - linha do tempo da integração Comece configurando seus Product IDs e Prices por meio do PlayMarket. Inicialmente, todos os produtos são sem identidade: são entidades digitais que seu jogador pode comprar, mas não têm significado para os jogadores do PlayFab. Para tornar essas entidades úteis, precisamos espelhá-las nos catálogos de itens do PlayFab. Isso transforma as entidades sem identidade em pacotes, contêineres e itens individuais. Cada um tem sua própria identidade exclusiva, com:
  • Títulos
  • Descrições
  • Marcas
  • Tipos
  • Imagens
  • Comportamentos
Todos eles são vinculados aos produtos do mercado por meio do compartilhamento de IDs. A melhor maneira de acessar os itens de dinheiro real disponíveis para compra é usar GetCatalogItems e GetStoreItems. Esses são os mesmos métodos de API usados pelas lojas de moeda gratuita, portanto o processo deve ser familiar. O ID do item é o vínculo entre o PlayFab e qualquer sistema de IAP externo. Por isso, passamos o ID do item para o serviço de IAP. Nesse ponto, o processo de compra começa. O jogador interage com a interface de IAP e, se a compra for bem-sucedida, você obtém um recibo. O PlayFab então consegue validar o recibo e registrar a compra, concedendo ao jogador do PlayFab os itens que ele acabou de comprar. Essa é uma ideia geral de como a integração de IAP funciona, e o exemplo a seguir mostra a maior parte dela em ação.

Configurar um aplicativo cliente

Esta seção mostra como configurar um aplicativo bem simples para testar IAP usando o PlayFab, o UnityIAP e a Android Billing API. Pré-requisitos:
  • Um projeto do Unity.
  • O SDK do PlayFab importado e configurado para funcionar com seu título.
Nossa primeira etapa é configurar o UnityIAP:
  1. Navegue até Services.
  2. Verifique se a guia Services está selecionada.
  3. Selecione seu perfil ou organização de Unity Services.
  4. Selecione o botão Create.
Configurar o serviço UnityIAP
  1. Em seguida, navegue até o serviço In-App Purchasing (IAP).
Navegar até o serviço UnityIAP
  1. Certifique-se de habilitar o Service, ativando a opção Simplify cross-platform IAP.
  2. Em seguida, selecione o botão Continue.
Habilitar o serviço UnityIAP Uma página com uma lista de plug-ins será exibida.
  1. Selecione o botão Import.
Serviço UnityIAP - Importar plug-ins Continue o procedimento de instalação e importação do Unity até o ponto em que todos os plug-ins tenham sido importados.
  1. Verifique se os plug-ins estão no lugar.
  2. Em seguida, crie um novo script chamado AndroidIAPExample.cs.
UnityIAP - Criar novo script AndroidIAPExample.cs conterá o código mostrado abaixo (consulte os comentários do código para obter mais explicações).
  1. Crie um novo objeto Game chamado Code.
  2. Adicione o componente AndroidIAPExample a ele (processo de 2 etapas).
  3. Adicione o componente AndroidIAPExample a ele.
  4. Certifique-se de salvar a cena.
UnityIAP - Criar objeto de jogo de exemplo Por fim, navegue até Build Settings.
  1. Verifique se sua cena foi adicionada à área Scenes In Build.
  2. Certifique-se de que a plataforma Android esteja selecionada.
  3. Vá para a área Player Settings.
  4. Atribua seu Package Name.
Certifique-se de criar seu próprio nome de pacote para evitar conflitos no PlayMarket.
UnityIAP - Adicionar objeto de jogo de exemplo Por fim, compile o aplicativo normalmente e verifique se você tem um APK pronto e funcionando. Ainda não temos como testá-lo. Primeiro, precisamos configurar o PlayMarket e o PlayFab, o que é descrito nas seções a seguir.

Configurar um aplicativo do PlayMarket para IAP

Esta seção descreve os detalhes de como habilitar IAP para seu aplicativo do PlayMarket.
A configuração do aplicativo em si está além do escopo deste tutorial. Presumimos que você já tenha um aplicativo e que ele esteja configurado para publicar pelo menos versões Alpha.
Habilitar o aplicativo do PlayMarket Observações úteis:
  • Chegar a esse ponto exigirá que você tenha um APK carregado. Use o APK que criamos na seção anterior.
  • Quando for solicitado a carregar o APK, você poderá carregá-lo como um aplicativo Alpha ou Beta para habilitar a área restrita de IAP.
  • A configuração da Content Rating incluirá perguntas sobre como o IAP está habilitado no aplicativo.
  • O PlayMarket não permite que os editores usem ou testem IAP; portanto, escolha outra conta do Google para fins de teste e adicione-a como testadora do seu build Alpha/Beta.
Depois de publicar o build do aplicativo:
  1. Selecione In-app products no menu.
    • Se for solicitada uma Merchant Account, vincule ou crie uma.
  2. Selecione o botão Add New Product.
PlayMarket - Adicionar novo produto
  1. Na tela mostrada abaixo, selecione Managed Product.
  2. Dê a ele um Product ID descritivo.
  3. Selecione Continue.
PlayMarket - Adicionar ID do produto O PlayMarket exige que você preencha um Title (1) e uma Description (2). No entanto, eles não são muito úteis no nosso caso. Obteremos os dados de Data Item exclusivamente do serviço PlayFab e só precisaremos que os IDs correspondam. PlayMarket - Adicionar título e descrição do produto
  1. Role mais para baixo e selecione o botão Add a price.
PlayMarket - Adicionar preço do produto
  1. Insira um preço válido (observe como o preço é convertido para cada país/região de forma independente).
  2. Selecione o botão Apply.
PlayMarket - Aplicar preços locais do produto
  1. Por fim, role de volta para o topo da tela e altere o status do item para Active.
PlayMarket - Ativar produto Embora isso conclua a configuração do aplicativo, precisamos de mais alguns ajustes. Primeiro, vamos salvar a Licensing Key (ela será útil para vincular o PlayFab ao PlayMarket.
  1. Navegue até Services & APIs no menu.
  2. Em seguida, localize e salve a versão Base64 da Key.
PlayMarket - Salvar chave de licenciamento do produto A próxima etapa é habilitar o teste de IAP. Embora a área restrita seja habilitada automaticamente para builds Alpha e Beta, precisamos configurar as contas autorizadas a testar o aplicativo:
  1. Navegue até Home.
  2. Localize e selecione Account details no menu à esquerda.
  3. Localize a área License Testing.
  4. Verifique se suas Test Accounts estão na lista.
  5. Certifique-se de que a License Test Response esteja definida como RESPOND_NORMALLY.
Não se esqueça de aplicar as configurações! PlayMarket - Habilitar teste de IAP O lado do Play Market da integração deve estar configurado neste ponto.

Configurar um título do PlayFab

Nossa última etapa é configurar um título do PlayFab para refletir nossos produtos e integrá-lo à Google Billing API.
  1. Selecione Add-ons.
  2. Em seguida, selecione o complemento Google.
PlayFab - Abrir o complemento Google
  1. Preencha seu Package ID.
  2. Preencha a Google App License Key que você obteve na seção anterior.
  3. Confirme suas alterações selecionando o botão Install Google.
PlayFab - Instalar o complemento Google Nossa próxima etapa é refletir nosso item Golden Sword no PlayFab:
  1. Selecione Economy.
  2. Verifique se a subguia Catalogs está selecionada.
  3. Selecione New Catalog.
  4. Forneça um nome para Catalog version.
  5. Selecione Save Catalog.
PlayFab - Salvar catálogo Se o catálogo não tiver itens, ele será removido automaticamente. É por isso que qualquer novo catálogo vem com um item pré-adicionado chamado One. Sempre podemos criar um item novo, mas, para manter tudo organizado, vamos modificar o item One existente.
  1. Selecione o item para editar o Item ID de modo que corresponda ao ID no PlayMarket.
  2. Agora, edite o Display name e adicione uma Description.
Lembre-se de que esses dados não têm nada a ver com o Play Market Item Title e a Description; eles são totalmente independentes.
  1. Atribua um Price ao seu Item.
  2. Selecione Save Item para confirmar suas alterações.
PlayFab - Editar e salvar item de catálogo
Neste tutorial, IAP se refere principalmente a compras com dinheiro real. É por isso que usamos RM, a moeda especial de dinheiro real (Real Money). O valor no PlayFab é definido em centavos de dólar americano.
  1. Observe seu item na lista Item ID.
PlayFab - Lista de itens de catálogo Isso conclui a configuração do seu título do PlayFab.

Testes

Para fins de teste, baixe o aplicativo usando a versão Alpha/Beta.
  • Certifique-se de usar uma conta de teste e um dispositivo Android real.
  • Ao iniciar o aplicativo, você deverá ver o IAP inicializado e um botão representando seu item.
  • Selecione esse botão.
Aplicativo de teste - Botão Buy Golden Sword A compra por IAP será iniciada. Siga as instruções do Google Play até o ponto em que a compra seja bem-sucedida. Aplicativo de teste - Google Play - pagamento bem-sucedido Por fim, navegue até seu título no painel do Game Manager do PlayFab e localize New Events. Painel do Game Manager - novos eventos Isso significa que a compra foi fornecida, validada e encaminhada com sucesso para o ecossistema do PlayFab. Neste ponto, você integrou com sucesso o UnityIAP e a Android Billing API ao seu aplicativo do PlayFab.
Última modificação em 6 de outubro de 2026