Configurer votre première monnaie virtuelle
Economy v2 est désormais en disponibilité générale. Pour obtenir de l’aide et faire part de vos commentaires, rendez-vous sur le forum PlayFab.
Prérequis
- Un compte de développeur PlayFab
- Le SDK PlayFab bêta (vous trouverez plus d’informations dans le démarrage rapide Postman)
Obtenir un jeton d’entité de titre
Pour modifier les données de configuration de votre titre via les API, vous devez d’abord obtenir un jeton d’entité de titre. Vous trouverez plus d’informations dans le démarrage rapide PostmanCréer une monnaie virtuelle
Pour créer une monnaie virtuelle, vous devez créer un brouillon d’objet (Draft Item) de type Currency.Game Manager
- Accédez à l’onglet Economy dans Game Manager et sélectionnez Catalog (V2).
- Choisissez Currency et sélectionnez New currency.
- Modifiez le Title et ajoutez une Description, par exemple
Diamonds,Our in-game currency of choice.. - Sélectionnez Save and publish pour finaliser vos modifications.
- Vérifiez que votre monnaie apparaît dans la liste Currency.
API REST
Appelez CreateDraftItem. Utilisez le corps suivant :FriendlyIdest le code de la monnaie, qui peut contenir entre un et trois caractères alphanumériquesTitleest le nom d’affichage présenté aux joueursContentTypeest une catégorisation des objets Economy. Vous devez d’abord définir le type de contenu dans ⚙️ > Title Settings > Economy > Catalog (V2) Settings.StartDateest une chaîne de date et d’heure indiquant à partir de quand la monnaie est visible par les joueurs (par défaut, l’heure de création)
Résolution des problèmes
- Jeton d’entité manquant/expiré
- Si vous tentez d’appeler
CreateDraftItemet recevez une erreur401: Unauthorized, vous avez peut-être oublié d’obtenir un jeton d’entité de titre, ou celui-ci a peut-être expiré
- Si vous tentez d’appeler
- Le type de contenu
''n’est pas pris en charge- Si vous tentez d’appeler
CreateDraftItemet recevez une erreurCatalogBadRequestavec le message ci-dessus, vous devez d’abord créer un type de contenu dans l’onglet des paramètres du catalogue, sur la page des paramètres de votre titre dans Game Manager
- Si vous tentez d’appeler
Étapes suivantes
Maintenant que vous avez configuré votre première monnaie virtuelle, vous pouvez :- Ajouter la monnaie aux bundles PlayFab que vous vendez dans les magasins d’applications.
- Faire en sorte que le serveur de jeu attribue la monnaie à vos joueurs avec AddInventoryItems.
- Attribuer aux objets du catalogue des prix correspondant à la monnaie.
- Permettre aux joueurs d’acheter des objets du catalogue avec la monnaie à l’aide de PurchaseInventoryItems.
