Início rápido de itens (Economy Legado)
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!
- Configurar uma moeda virtual para o seu jogo.
- Dar moeda virtual a um jogador.
- Adicionar um item ao catálogo do seu jogo.
- Usar as APIs do PlayFab para comprar um item do catálogo usando moeda virtual.
- Usar as informações do Game Manager para confirmar que a compra foi bem-sucedida.
Configurar uma moeda virtual
O PlayFab oferece suporte a uma economia de jogo robusta com várias moedas e itens. Para acessar esses recursos e criar uma moeda virtual:- Abra o Game Manager e selecione Economy na barra lateral esquerda.
- Selecione a guia Currency e selecione New Currency (abre a tela New Currency mostrada abaixo).
- Para criar sua moeda virtual, edite estes campos:
- Defina Currency code (2 uppercase characters) como GD.
- Defina Display name como Gold.
- Selecione SAVE CURRENCY.
Dar moeda virtual a um jogador
Você pode dar moeda virtual diretamente aos jogadores. Como exemplo, vamos adicionar dinheiro a um jogador usando o Game Manager:- Selecione Players na barra lateral esquerda e, em seguida, selecione o ID de um jogador.
- Vá para a guia Virtual Currency do jogador.
- Escolha a moeda GD (abre a tela Modify Virtual Currency mostrada abaixo).
- Altere Amount para 100.
- Selecione SAVE VIRTUAL CURRENCY.
Adicionar um item ao catálogo do seu jogo
Não adianta ter dinheiro se não for possível gastá-lo! Você pode criar catálogos (uma coleção de itens) que correspondam às plataformas nas quais você está lançando seu jogo ou a números de versão principais, como preferir. Para criar um catálogo com um item:- Selecione Economy na barra lateral esquerda e selecione a guia Catalogs.
- Selecione o botão New Catalog e insira main como Catalog version. Um item com o ID One é adicionado automaticamente.
- Selecione One (abre a tela Edit Catalog Item mostrada abaixo). Edite estes campos:
- Defina Item ID como apple.
- Defina Display name como apple.
- Defina Description como Perfectly normal apple.
- Defina o preço da maçã em ouro (GD) como 5.
- Selecione SAVE ITEM.
Comprar um item usando moeda virtual
Vamos usar as APIs do PlayFab para fazer uma compra no seu jogo.- Entre como o jogador que recebeu 100 de ouro em moeda virtual (conforme descrito em Dar moeda virtual a um jogador).
- Chame GetCatalogItems com o seguinte parâmetro na solicitação:
CatalogVersion = "main"
- Verifique se o
Catalogno resultado contém uma apple com um preço em GD de 5. - Compre a maçã chamando PurchaseItem com estes valores de parâmetro na solicitação:
CatalogVersion = "main"ItemId = "apple"VirtualCurrency = "GD"Price = 5
- Por fim, chame GetUserInventory e observe o resultado desse método. Na matriz de itens do inventário do jogador, você deverá ver uma maçã!
Confirmar que a compra foi bem-sucedida
Para confirmar a compra no Game Manager:- Selecione Players na barra lateral esquerda para abrir a guia Players.
- Selecione o ID do jogador que comprou o item.
- Abra a guia PlayStream. Você deverá ver um evento Player virtual currency item purchased.
- Abra a guia Inventory. O inventário agora deve conter uma maçã. Você também pode usar recursos na guia Inventory para revogar o item ou conceder mais maçãs ao jogador.
- Abra a guia Virtual Currency. O jogador deve ter apenas 95 de ouro restantes.