​

Início rápido: adicione seu primeiro item ao inventário de um jogador

​

Pré-requisitos

• Uma conta de desenvolvedor do PlayFab
• O SDK Beta do PlayFab (você pode encontrar mais informações no Início rápido do Postman)
• Pelo menos um item no seu catálogo (você pode encontrar mais informações no Início rápido do Economy v2)
• Pelo menos um jogador com moeda virtual suficiente para comprar um item

​

Entrar como o jogador

​

Pesquisar o item

{
  "Search": "[Item Title]",
  "Top": 1
}

• Search é a cadeia de caracteres de pesquisa usada em uma pesquisa difusa no Title, na Description e nas Keywords de cada item do seu catálogo
• Top é um inteiro que determina quantos resultados retornar; neste caso, precisamos de apenas um

• Items > Id - ID do item no catálogo
• Items > PriceOptions > Prices > Amounts > ItemId - ID da moeda virtual usada para comprar o item
• Items > PriceOptions > Prices > Amounts > Amount - Quantidade de moeda virtual necessária para comprar o item

​

Comprar o item

{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}

• Item.Id é a ID do item (obtida da resposta de Search na etapa anterior)
• Amount é o número de itens que o jogador está comprando
• ItemId é a ID da moeda virtual usada para comprar o item (obtida da resposta de Search na etapa anterior)
• Amount é a quantidade de moeda virtual necessária para comprar o item (obtida da resposta de Search na etapa anterior)

​

Obter os itens do inventário do jogador

​

Solução de problemas

• Fundos insuficientes
  • Se você chamar PurchaseInventoryItems e receber um erro 422: InsufficientFunds, o jogador não tem moeda virtual suficiente para comprar o item. Você pode conceder moeda virtual ao jogador chamando AddInventoryItems (requer token de entidade de título) ou navegando até [Title] > Players > [Player] > Inventory (V2) no Game Manager.
• O item não pode ser comprado pelo preço especificado.
  • Se você chamar PurchaseInventoryItems e receber o código de erro 1071, o campo PriceAmounts não corresponde aos preços especificados no catálogo.

​

Próximas etapas