​

Démarrage rapide : ajouter votre premier objet à l’inventaire d’un joueur

​

Prérequis

• Un compte développeur PlayFab
• Le SDK bêta de PlayFab (vous trouverez plus d’informations dans le démarrage rapide Postman)
• Au moins un objet dans votre catalogue (vous trouverez plus d’informations dans le démarrage rapide Economy v2)
• Au moins un joueur disposant de suffisamment de devise virtuelle pour acheter un objet

​

Se connecter en tant que joueur

​

Rechercher l’objet

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

• Search est la chaîne de recherche utilisée pour une recherche approximative dans le titre, la description et les mots clés de chaque objet de votre catalogue
• Top est un entier qui détermine le nombre de résultats à renvoyer ; dans ce cas, nous n’en avons besoin que d’un seul

• Items > Id - ID de catalogue de l’objet
• Items > PriceOptions > Prices > Amounts > ItemId - ID de la devise virtuelle utilisée pour acheter l’objet
• Items > PriceOptions > Prices > Amounts > Amount - Quantité de devise virtuelle nécessaire pour acheter l’objet

​

Acheter l’objet

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

• Item.Id est l’ID de l’objet (extrait de la réponse Search de l’étape précédente)
• Amount est le nombre d’objets que le joueur achète
• ItemId est l’ID de la devise virtuelle utilisée pour acheter l’objet (extrait de la réponse Search de l’étape précédente)
• Amount est la quantité de devise virtuelle nécessaire pour acheter l’objet (extraite de la réponse Search de l’étape précédente)

​

Obtenir les objets d’inventaire du joueur

​

Résolution des problèmes

• Fonds insuffisants
  • Si vous appelez PurchaseInventoryItems et recevez une erreur 422: InsufficientFunds, le joueur ne dispose pas de suffisamment de devise virtuelle pour acheter l’objet. Vous pouvez octroyer de la devise virtuelle au joueur en appelant AddInventoryItems (nécessite un jeton d’entité de titre) ou en accédant à [Title] > Players > [Player] > Inventory (V2) dans Game Manager.
• L’objet ne peut pas être acheté au prix spécifié.
  • Si vous appelez PurchaseInventoryItems et recevez le code d’erreur 1071, le champ PriceAmounts ne correspond pas aux prix spécifiés dans le catalogue.

​

Étapes suivantes