Passer au contenu principal

Démarrage rapide : Ajouter votre premier article à l’inventaire d’un joueur

Economy v2 est maintenant en disponibilité générale. Pour obtenir du soutien et donner vos commentaires, rendez-vous sur le forum PlayFab.
Familiarisez-vous avec les inventaires des joueurs en utilisant le SDK bêta PlayFab pour acheter un article et vérifier qu’il a été ajouté à l’inventaire de votre joueur. Après avoir obtenu un jeton d’entité pour interagir avec votre titre au moyen des API, vous recherchez un article dans votre catalogue, l’achetez, puis obtenez l’inventaire du joueur pour y trouver l’article acheté.

Prérequis

Se connecter en tant que joueur

Vous devez d’abord connecter le joueur pour recevoir le jeton de sécurité requis pour les autres appels d’API de ce démarrage rapide. Vous trouverez plus d’information à la page Authentification des joueurs.

Rechercher l’article

Pour trouver l’article dans le catalogue, appelez Search. Dans le corps de l’appel :
  • Search est la chaîne de recherche qui fait l’objet d’une recherche approximative dans le titre, la description et les mots clés de chaque article de votre catalogue
  • Top est un entier qui détermine le nombre de résultats à retourner; dans ce cas-ci, nous n’en avons besoin que d’un seul
D’autres champs sont présentés dans le démarrage rapide de la recherche.
Dans la réponse, récupérez les champs suivants :
  • Items > Id - ID de catalogue de l’article
  • Items > PriceOptions > Prices > Amounts > ItemId - ID de la devise virtuelle utilisée pour acheter l’article
  • Items > PriceOptions > Prices > Amounts > Amount - Quantité de devise virtuelle nécessaire pour acheter l’article
Seules les entités de titre peuvent définir les prix des articles.

Acheter l’article

Pour acheter l’article, appelez PurchaseInventoryItems. Dans le corps de l’appel :
  • Item.Id est l’ID de l’article (tiré de la réponse de Search à l’étape précédente)
  • Amount est le nombre d’articles que le joueur achète
  • ItemId est l’ID de la devise virtuelle utilisée pour acheter l’article (tiré de la réponse de Search à l’étape précédente)
  • Amount est la quantité de devise virtuelle nécessaire pour acheter l’article (tirée de la réponse de Search à l’étape précédente)

Obtenir les articles d’inventaire du joueur

Consultez l’article nouvellement acheté par le joueur au moyen de GetInventoryItems. Dans l’appel, assurez-vous que le corps est vide; vous pouvez spécifier l’entité dans le corps, mais ce n’est pas nécessaire, car l’information est déjà transmise au moyen du jeton d’entité dans l’en-tête. La réponse contient les ID de chaque article que possède le joueur et la quantité de chaque article. L’article nouvellement acheté se trouve dans l’inventaire du joueur.
Si le joueur possède déjà cet article dans son inventaire avec le même StackId, vous ne verrez pas une autre instance de l’article après l’achat; vous verrez plutôt le champ Amount augmenter.

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’article. Vous pouvez octroyer de la devise virtuelle au joueur en appelant AddInventoryItems (nécessite un jeton d’entité de titre) ou en accédant à [Titre] > Players > [Joueur] > Inventory (V2) dans Game Manager.
  • L’article 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

Maintenant que vous avez acheté le premier article du joueur, vous pouvez consommer l’article, l’ajouter à une boutique pour le mettre en vente, et créer et acheter un ensemble contenant l’article.
[!div class=“nextstepaction”] Tutoriel sur l’inventaire des joueurs
[!div class=“nextstepaction”] Boutiques
[!div class=“nextstepaction”] Ensembles
Dernière modification le 6 octobre 2026