Início rápido de lojas (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!
- Adicionar itens a um catálogo com preços normais.
- Criar uma loja que contém os mesmos itens com preços com desconto.
- Usar as APIs do PlayFab para comprar um item da loja.
- Usar as informações do Game Manager para confirmar que o item foi comprado pelo preço com desconto da loja.
Adicionar itens a um catálogo
Primeiro, vamos adicionar alguns itens para vender no seu catálogo:- Abra o Game Manager e selecione Economy na barra lateral esquerda.
- Selecione a guia Catalogs e abra seu catálogo main.
- Selecione New Item algumas vezes e crie alguns itens:
- apricot com um preço em GD de 4.
- pear com um preço em GD de 3.
- grape sem preço em GD (não selecione nenhum preço).
Criar uma loja
Agora você deve ter alguns itens com preços no seu catálogo. Vamos criar uma loja para vendê-los a um jogador.- Abra seu catálogo main e selecione Stores.
- Selecione New store.
- Defina Store Id e Store name como fruits (conforme mostrado no exemplo a seguir).
- Selecione ADD TO STORE.
- Uma tela pop-up, como a mostrada abaixo, exibirá todos os itens, pacotes e contêineres do catálogo atual.
- Adicione alguns itens à sua loja selecionando o botão Add ao lado do item.
Definir o preço de loja de um item
Agora você deve ver seus itens listados em STORE CONTENTS, mas eles não são válidos até terem pelo menos um preço. O pequeno número estático (por exemplo, < 4) ao lado da caixa de texto do preço é o preço original do catálogo. Você só precisa inserir um preço em uma caixa de cada linha, mas pode inserir quantos preços quiser.- Se você não inserir nenhum preço para um item, ele será removido da loja.
- Se um item da loja não tiver um preço em uma moeda, ele não poderá ser comprado com essa moeda.
- Os preços da loja podem ser maiores que os preços do catálogo, e zero é um preço válido para um item.
- Adicione alguns preços em GD aos seus itens, mas deixe-os menores que os preços do catálogo:
- Apricot: 3.
- Pear: 2.
- Grape: 1.
- Selecione SAVE STORE quando terminar.
Comprar um item da loja
Agora que você tem uma loja, vamos usar as APIs do PlayFab para comprar um item da loja no seu jogo.- Obtenha sua loja chamando GetStoreItems com estes parâmetros na solicitação:
CatalogVersion = "main"StoreId = "fruits"
- O campo
Storeem GetStoreItemsResult deve conter uma lista dos itens da sua loja e seus preços. - Chame PurchaseItem com valores na solicitação que especifiquem a moeda e o preço de loja do item que você deseja comprar.
CatalogVersion = "main"StoreId = "fruits"ItemId = "pear"VirtualCurrency = "GD"Price = 2
Confirmar o preço de compra
Abra o Game Manager e confirme que a compra foi feita pelo preço de loja de dois GD.- Selecione Players na barra lateral esquerda para abrir a guia Players.
- Selecione o ID do jogador que comprou o item.
- Verifique as seguintes informações do jogador:
- Abra a guia Inventory. O inventário agora deve conter uma pear.
- Abra a guia Virtual Currency. Verifique o Amount da moeda virtual para confirmar que o jogador gastou apenas 2 GD.
- Abra a guia PlayStream. Você verá eventos mostrando o fluxo de compra na loja. Os eventos incluem um evento Player virtual currency item purchased e um evento Player virtual currency balance changed mostrando que o saldo de moeda virtual foi alterado em dois GD.