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.
Prérequis
- Un compte de développeur PlayFab
- Le SDK bêta PlayFab (vous trouverez plus d’information dans le démarrage rapide Postman)
- Au moins un article dans votre catalogue (vous trouverez plus d’information dans le démarrage rapide d’Economy v2)
- Au moins un joueur disposant de suffisamment de devise virtuelle pour acheter un article
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, appelezSearch. Dans le corps de l’appel :
Searchest 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 catalogueTopest 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.
Items>Id- ID de catalogue de l’articleItems>PriceOptions>Prices>Amounts>ItemId- ID de la devise virtuelle utilisée pour acheter l’articleItems>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, appelezPurchaseInventoryItems. Dans le corps de l’appel :
Item.Idest l’ID de l’article (tiré de la réponse deSearchà l’étape précédente)Amountest le nombre d’articles que le joueur achèteItemIdest l’ID de la devise virtuelle utilisée pour acheter l’article (tiré de la réponse deSearchà l’étape précédente)Amountest la quantité de devise virtuelle nécessaire pour acheter l’article (tirée de la réponse deSearchà l’étape précédente)
Obtenir les articles d’inventaire du joueur
Consultez l’article nouvellement acheté par le joueur au moyen deGetInventoryItems. 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
PurchaseInventoryItemset recevez une erreur422: 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 appelantAddInventoryItems(nécessite un jeton d’entité de titre) ou en accédant à [Titre] > Players > [Joueur] >Inventory (V2)dans Game Manager.
- Si vous appelez
- L’article ne peut pas être acheté au prix spécifié.
- Si vous appelez
PurchaseInventoryItemset recevez le code d’erreur1071, le champPriceAmountsne correspond pas aux prix spécifiés dans le catalogue.
- Si vous appelez
É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
