Démarrage rapide des objets (Economy hérité)
Les API Economy v1 sont en mode maintenance et ne recevront aucune nouvelle fonctionnalité, seulement des correctifs de bogues. Les API v1 seront maintenues dans un avenir prévisible. Consultez la vue d’ensemble d’Economy v2 pour en savoir plus sur la prochaine version de PlayFab Economy!
- Configurer une monnaie virtuelle pour votre jeu.
- Donner de la monnaie virtuelle à un joueur.
- Ajouter un objet à votre catalogue en jeu.
- Utiliser les API PlayFab pour acheter un objet du catalogue avec de la monnaie virtuelle.
- Utiliser l’information de Game Manager pour confirmer que l’achat a réussi.
Configuration d’une monnaie virtuelle
PlayFab prend en charge une économie de jeu robuste comportant plusieurs monnaies et objets. Pour accéder à ces fonctionnalités et créer une monnaie virtuelle :- Ouvrez Game Manager et sélectionnez Economy dans la barre latérale gauche.
- Sélectionnez l’onglet Currency, puis New Currency (ce qui ouvre l’écran New Currency illustré ci-dessous).
- Pour créer votre monnaie virtuelle, modifiez ces champs :
- Réglez Currency code (2 uppercase characters) à GD.
- Réglez Display name à Gold.
- Sélectionnez SAVE CURRENCY.
Donner de la monnaie virtuelle à un joueur
Vous pouvez donner directement de la monnaie virtuelle aux joueurs. À titre d’exemple, ajoutons de l’argent à un joueur à l’aide de Game Manager :- Sélectionnez Players dans la barre latérale gauche, puis sélectionnez l’ID d’un joueur.
- Accédez à l’onglet Virtual Currency du joueur.
- Choisissez la monnaie GD (ce qui ouvre l’écran Modify Virtual Currency illustré ci-dessous).
- Remplacez Amount par 100.
- Sélectionnez SAVE VIRTUAL CURRENCY.
Ajout d’un objet à votre catalogue en jeu
Inutile d’avoir de l’argent si vous ne pouvez pas le dépenser! Vous pouvez créer des catalogues (une collection d’objets) qui correspondent aux plateformes sur lesquelles vous publiez votre jeu, ou aux numéros de version majeure, selon ce que vous préférez. Pour créer un catalogue contenant un objet :- Sélectionnez Economy dans la barre latérale gauche, puis l’onglet Catalogs.
- Sélectionnez le bouton New Catalog et entrez main comme Catalog version. Un objet ayant l’ID One est ajouté automatiquement.
- Sélectionnez One (ce qui ouvre l’écran Edit Catalog Item illustré ci-dessous). Modifiez ces champs :
- Réglez Item ID à apple.
- Réglez Display name à apple.
- Réglez Description à Perfectly normal apple.
- Réglez le prix de la pomme en or (GD) à 5.
- Sélectionnez SAVE ITEM.
Achat d’un objet avec de la monnaie virtuelle
Utilisons les API PlayFab pour effectuer un achat dans votre jeu.- Connectez-vous en tant que joueur ayant reçu 100 pièces d’or en monnaie virtuelle (comme décrit dans Donner de la monnaie virtuelle à un joueur).
- Appelez GetCatalogItems avec le paramètre suivant dans la requête :
CatalogVersion = "main"
- Vérifiez que le
Catalogdu résultat contient un objet apple au prix de 5 GD. - Achetez la pomme en appelant PurchaseItem avec ces valeurs de paramètres dans la requête :
CatalogVersion = "main"ItemId = "apple"VirtualCurrency = "GD"Price = 5
- Enfin, appelez GetUserInventory et examinez le résultat de cette méthode. Dans le tableau des objets de l’inventaire du joueur, vous devriez voir une pomme!
Confirmation de la réussite de l’achat
Pour confirmer l’achat dans Game Manager :- Sélectionnez Players dans la barre latérale gauche pour ouvrir l’onglet Players.
- Sélectionnez l’ID du joueur qui a acheté l’objet.
- Ouvrez l’onglet PlayStream. Vous devriez voir un événement Player virtual currency item purchased.
- Ouvrez l’onglet Inventory. L’inventaire devrait maintenant contenir une pomme. Vous pouvez également utiliser les fonctionnalités de l’onglet Inventory pour révoquer l’objet ou accorder davantage de pommes au joueur.
- Ouvrez l’onglet Virtual Currency. Il ne devrait plus rester que 95 pièces d’or au joueur.