O Economy v2 agora está em disponibilidade geral. Para obter suporte e enviar comentários, acesse o Fórum do PlayFab.
Pré-requisitos
O início rápido do PlayFab Economy v2 prepara você para executar a validação de recibos.Validação de recibos do marketplace da Microsoft Store
Para usar a API Redeem, comece configurando os IDs de produto e os preços no marketplace que você estiver usando (Apple Store, Steam, Google Play etc.). Inicialmente, todos os produtos são genéricos (entradas digitais que o jogador pode comprar), mas não têm significado no PlayFab. Para dar significado a essas entradas, precisamos espelhá-las no Catálogo do PlayFab. Espelhá-las transformará as entidades genéricas em Pacotes do Catálogo. Quando você chamaRedeemMicrosoftStoreInventoryItems no novo serviço, procuramos no Catálogo um Pacote correspondente para conceder ao Inventário virtual da entidade jogador.
Cada Pacote pode ser vinculado a um ou mais Produtos de Marketplaces Parceiros adicionando um AlternateId a ele. O AlternateId é o vínculo entre o PlayFab e qualquer mercado de IAP externo. Quando seu título chama Redeem para uma determinada entidade de jogador, enviamos esse ID ao mercado de IAP para verificação. O fluxo geral é:
- Crie 1 (ou mais) ofertas do mundo real na Microsoft Store
- Preencha os Complementos no PlayFab com permissões de chamada do mercado de IAP e crie Pacotes correspondentes no PlayFab vinculados às ofertas que você criou
- Chame
RedeemMicrosoftStoreInventoryItems
Diferentemente das versões anteriores do PlayFab, no novo sistema você cria apenas uma oferta de pacote e depois adiciona cada SKU de mercado que precisa ser referenciado à lista AlternateId. Você não precisa criar um novo Item para cada mercado de IAP.
Etapa 1 - Configurar a integração com o marketplace
Você precisa configurar cada integração com mercados de IAP no GameManager, na seção Add-ons, para permitir que o PlayFab chame o mercado em nome do título.Etapa 2 - Criar um pacote para validação de recibos
Você pode criar um pacote no GameManager ou chamandoCreateDraftItem. No mínimo, um Pacote exige um Title, uma Description e Items. No GameManager, você pode vincular entradas de marketplace usando a seção Marketplace Mapping.
Se você estiver criando o Pacote usando a API, precisará adicionar seus mapeamentos de marketplace de IAP na seção alternateIds de um pacote. Os enums de marketplace são específicos e diferenciam maiúsculas de minúsculas; você deve usar um dos seguintes Complementos:
- Apple = “AppleAppStore”
- Google Play = “GooglePlay”
- Nintendo = “NintendoEShop”
- Microsoft = “MicrosoftStore”
- PlayStation = “PlayStationStore”
- Steam = “Steam”
Etapa 3 - Chamar Redeem no seu jogo
Seu jogo chama a APIRedeemMicrosoftStoreInventoryItems com os detalhes da entidade e do recibo para ‘resgatar’ a oferta do mundo real e preencher o Inventário da entidade correspondente. Você precisa fornecer algumas informações na chamada para que ela funcione corretamente:
- Obrigatório no cabeçalho da solicitação
- X-EntityToken - O token que identifica exclusivamente uma entidade do PlayFab
- Content-Type - Application/Json
- Obrigatório no corpo da solicitação
CollectionsIdKey
Parte 4: Comprar um item
Game Manager
Você pode verificar se Itens ou Moedas existem nas visualizações individuais dos jogadores. No GameManager, selecione Players e navegue até uma entidade de jogador individual. Use as guias de Inventário para visualizar e atualizar o que essa entidade jogador possui.API
No seu jogo, entre como um jogador que recebeu moeda virtual. ChameSearchItems para usar um itemId de catálogo publicado anteriormente.
Chame PurchaseInventoryItems com o itemId do item do catálogo e o ID da moeda virtual concedida.
Por fim, chame GetInventoryItems e veja o resultado desse método.
Você pode saber mais sobre monetização na plataforma Microsoft aqui.