Passer au contenu principal

Configurer votre première monnaie virtuelle

Economy v2 est maintenant en disponibilité générale. Pour obtenir du soutien et transmettre vos commentaires, rendez-vous sur le forum PlayFab.
Commencez à utiliser PlayFab Economy en vous servant du SDK PlayFab Services pour configurer votre première monnaie virtuelle. Après avoir obtenu un jeton d’entité pour interagir avec votre titre au moyen des API, vous créez et configurez une monnaie virtuelle.

Prérequis

Obtenir un jeton d’entité de titre

Pour modifier les données de configuration de votre titre au moyen des API, vous devez d’abord obtenir un jeton d’entité de titre. Vous trouverez plus d’information dans le démarrage rapide Postman

Créer une nouvelle monnaie virtuelle

Pour créer une nouvelle monnaie virtuelle, vous devez créer un objet brouillon (Draft Item) de type Currency.

Game Manager

  1. Accédez à l’onglet Economy dans Game Manager et sélectionnez Catalog (V2).
  2. Choisissez Currency et sélectionnez New currency.
  3. Modifiez le Title et ajoutez une Description, par exemple Diamonds, Our in-game currency of choice..
  4. Sélectionnez Save and publish pour appliquer vos modifications.
  5. Repérez votre monnaie dans la liste Currency.

API REST

Appelez CreateDraftItem. Utilisez le corps suivant :

  • Le FriendlyId est le code de la monnaie, qui peut contenir entre un et trois caractères alphanumériques
  • Le Title est le nom d’affichage présenté aux joueurs
  • ContentType est une catégorisation des objets d’Economy. Vous devez d’abord définir le type de contenu dans ⚙️ > Title Settings > Economy > Catalog (V2) Settings.
  • StartDate est une chaîne de date et d’heure indiquant à quel moment la monnaie devient visible pour les joueurs (par défaut, le moment de la création)

Dépannage

  • Jeton d’entité manquant ou expiré
    • Si vous tentez d’appeler CreateDraftItem et recevez une erreur 401: Unauthorized, vous avez peut-être oublié d’obtenir un jeton d’entité de titre, ou celui-ci est peut-être expiré
  • Le type de contenu '' n’est pas pris en charge
    • Si vous tentez d’appeler CreateDraftItem et recevez une erreur CatalogBadRequest avec le message ci-dessus, vous devez d’abord créer un type de contenu dans l’onglet des paramètres du catalogue, sous la page des paramètres de votre titre dans Game Manager

Étapes suivantes

Maintenant que vous avez configuré votre première monnaie virtuelle, vous pouvez :
  1. Ajouter la monnaie aux ensembles (Bundles) PlayFab que vous vendez dans les boutiques d’applications.
  2. Faire en sorte que le serveur de jeu récompense vos joueurs avec la monnaie au moyen d’AddInventoryItems.
  3. Attribuer aux objets du catalogue des prix correspondant à la monnaie.
  4. Permettre aux joueurs d’acheter des objets du catalogue avec la monnaie au moyen de PurchaseInventoryItems.
Dernière modification le 6 octobre 2026