Pular para o conteúdo principal

Introdução ao Economy v2, Unity e Android

O Economy v2 agora está em disponibilidade geral. Para obter suporte e enviar comentários, acesse o Fórum do PlayFab.
Este tutorial mostra como configurar compras no aplicativo (IAP) usando o PlayFab, o Unity + IAP Service e a Android Billing API.

Antes de começar

A Android Billing API e o PlayFab trabalham juntos para fornecer uma experiência de IAP para o seu cliente: PlayFab Economy v2 - Linha do tempo de resgate Comece configurando suas IDs de produto e Preços por meio do PlayMarket. Inicialmente, todos os produtos são sem identidade - entidades digitais que o seu jogador pode comprar - mas sem significado para os jogadores do PlayFab. Para tornar essas entidades úteis, precisamos espelhá-las nos catálogos de itens do PlayFab. O PlayFab transforma 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 os itens são vinculados aos produtos do marketplace por meio de IDs compartilhadas. A melhor maneira de acessar os itens de dinheiro real disponíveis para compra é usar GetItems. A ID do item é o vínculo entre o PlayFab e qualquer sistema de IAP externo. Portanto, passamos a 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 valida o recibo e registra a compra, concedendo ao jogador do PlayFab os itens que ele acabou de comprar.

Configurando um aplicativo cliente

Esta seção mostra como configurar um aplicativo para testar IAP usando o PlayFab, o UnityIAP e a Android Billing API. Pré-requisitos:
  • Um projeto do Unity.
  • O SDK do PlayFab para Unity importado e configurado para funcionar com o seu título.
  • Um editor como o Visual Studio instalado e configurado para funcionar com o seu projeto do Unity.
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 do Unity Services.
  4. Selecione o botão Create.
Configurando o serviço UnityIAP
  1. Em seguida, navegue até o serviço In-App Purchasing (IAP).
Navegar até o serviço UnityIAP
  1. Habilite 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 é 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 contendo o código a seguir (consulte os comentários do código para obter mais explicações).
  1. Crie um novo GameObject chamado Code.
  2. Adicione o componente AndroidIAPExample a ele (clique e arraste, ou).
  3. Certifique-se de salvar a cena.
UnityIAP - Criar objeto de jogo de exemplo Por fim, navegue até Build Settings.
  1. Verifique se a sua cena foi adicionada à área Scenes In Build.
  2. Verifique se a plataforma Android foi selecionada.
  3. Vá para a área Player Settings.
  4. Atribua o seu Package Name.
Crie o seu próprio nome de pacote para evitar conflitos no PlayMarket.
UnityIAP - Adicionar objeto de jogo de exemplo Por fim, compile o aplicativo como de costume e verifique se há um APK. Para testar, precisamos configurar o PlayMarket e o PlayFab.

Configurando um aplicativo do PlayMarket para IAP

Esta seção descreve os detalhes de como habilitar IAP para o 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 aplicativo do PlayMarket Observações úteis:
  • Chegar a esse ponto exige que você tenha carregado um APK. Use o APK que construímos na seção anterior.
  • Carregue o APK como um aplicativo Alpha ou Beta para habilitar a área restrita de IAP.
  • A configuração de Content Rating inclui perguntas sobre como o IAP está habilitado no aplicativo.
  • O PlayMarket não permite que os editores usem ou testem IAP. Escolha outra conta do Google para fins de teste e adicione-a como testador da sua versão Alpha/Beta.
  1. Publique a versão do aplicativo.
  2. Selecione In-app products no menu.
    • Se for solicitada uma Merchant Account, vincule ou crie uma.
  3. Selecione o botão Add New Product. PlayMarket - adicionar novo produto
  4. Na tela do novo produto, selecione Managed Product.
  5. Dê a ele uma ID de produto descritiva, como 100diamonds.
  6. Selecione Continue. PlayMarket - adicionar ID do produto
  7. O PlayMarket exige que você preencha um Title (1) e uma Description (2), por exemplo, 100 Diamonds e A pack of 100 diamonds to spend in-game. Os dados do Data Item vêm exclusivamente do serviço PlayFab e só exigem que as IDs correspondam. PlayMarket - adicionar título e descrição do produto
  8. Role mais para baixo e selecione o botão Add a price. PlayMarket - adicionar preço do produto
  9. Insira um preço válido, como “$0.99” (observe como o preço é convertido para cada país/região de forma independente).
  10. Selecione o botão Apply. PlayMarket - aplicar preços locais do produto
  11. Por fim, role de volta até o topo da tela e altere o status do item para Active. PlayMarket - ativar o produto
  12. Salve a Licensing Key para vincular o PlayFab ao PlayMarket.
  13. Navegue até Services & APIs no menu.
  14. 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 versões 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 as suas Test Accounts estão na lista.
  5. Verifique se License Test Response está definido 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.

Configurando 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 do Google
  1. Preencha a sua 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.
Nossa próxima etapa é refletir nosso pacote de 100 diamantes no PlayFab:

Game Manager

  1. Crie uma nova Moeda do Economy Catalog (V2).
  2. Edite o Title e adicione uma Description - por exemplo, Diamonds, Our in-game currency of choice..
  3. Adicione uma Friendly ID para facilitar a localização da sua moeda, diamonds.
  4. Selecione Save and publish para concluir suas alterações.
  5. Observe sua moeda na lista Currency.
  6. Em seguida, crie um novo Pacote do Economy Catalog (V2).
  7. Edite o Title e adicione uma Description - por exemplo, 100 Diamonds Bundle, A pack of 100 diamonds to spend in-game..
Lembre-se de que esses dados não têm nada a ver com o Title e a Description do item no Play Market; eles são independentes.
  1. Você pode usar o tipo de conteúdo para organizar seus pacotes - por exemplo, appstorebundles. Os tipos de conteúdo são gerenciados em ⚙️ > Title Settings > Economy (V2).
  2. Acompanhe os preços do mundo real adicionando preços localizados às propriedades de exibição.
  3. Adicione um novo item ao pacote. Selecione Currencies no filtro e escolha a moeda que você criou na etapa anterior. Defina Quantity para corresponder à quantidade de moeda que você deseja vender neste pacote.
  4. Adicione uma nova plataforma para o marketplace “GooglePlay”. Se você ainda não tiver o marketplace GooglePlay, poderá criá-lo na página Economy Settings. Defina a Marketplace ID para corresponder à ID do produto do Google Play Console que você criou na seção anterior.
  5. Selecione Save and publish para concluir suas alterações.
  6. Observe seu pacote na lista Bundles.

API REST


Em seguida, podemos definir compras no jogo para os jogadores gastarem sua moeda, com uma loja do PlayFab representando um vendedor NPC no jogo:

Game Manager

  1. Crie um novo Item do Economy Catalog (V2).
  2. Edite o Title e adicione uma Description - por exemplo, “Golden Sword”, “A sword made of gold.”.
  3. Você pode adicionar palavras-chave localizadas para ajudar os jogadores a encontrar seu item na loja. Adicione marcas e um tipo de conteúdo para ajudar a organizar seus itens para recuperação posterior por meio da API. Use as propriedades de exibição para armazenar dados do jogo, como valores de armadura, um caminho relativo para ativos de arte ou quaisquer outros dados que você precise armazenar para o seu jogo.
  4. Adicione um novo preço e selecione a moeda que você criou na etapa anterior. Defina Amount como o preço padrão desejado. Você pode substituir o preço posteriormente em qualquer loja que criar.
  5. Selecione Save and publish para concluir suas alterações.
  6. Observe seu item na lista Items.
  7. Por fim, crie uma nova Loja do Economy Catalog (V2).
  8. Edite o Title e adicione uma Description - por exemplo, Villager Store, A humble store run by a humble villager..
  9. Dê a ela uma Friendly ID para facilitar a recuperação, por exemplo, villagerstore.
  10. Adicione à loja o item que você criou na etapa anterior. Você pode adicionar vários itens a uma loja e substituir quaisquer preços padrão, se necessário.
  11. Selecione Save and publish para concluir suas alterações.
  12. Observe sua loja na lista Stores.

API REST


Concluímos a configuração do seu título do PlayFab.

Testes

Para fins de teste, baixe o aplicativo usando a versão Alpha/Beta.
  • Use 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 Comprar 100 diamantes A compra por IAP é 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é o seu título no painel do Game Manager do PlayFab e localize New Events. Verifique se a compra foi fornecida, validada e encaminhada para o ecossistema do PlayFab. Você integrou com êxito o UnityIAP e a Android Billing API ao seu aplicativo do PlayFab!

Próximas etapas

  1. Crie uma interface do Unity UI Toolkit para compras para substituir a exibição IMGUI de demonstração.
  2. Crie um Unity Logger personalizado para tratar erros do PlayFab e exibi-los ao usuário.
  3. Adicione imagens de ícone ao campo Images dos seus itens do PlayFab para exibição na interface do Unity.
Última modificação em 6 de outubro de 2026