Skip to main content

Prise en main d’Economy v2, d’Unity et d’Android

Economy v2 est maintenant en disponibilité générale. Pour obtenir du soutien et donner vos commentaires, rendez-vous sur le forum PlayFab.
Ce tutoriel vous montre comment configurer les achats intégrés (IAP) à l’aide de PlayFab, du service Unity + IAP et de l’API Android Billing.

Avant de commencer

L’API Android Billing et PlayFab fonctionnent ensemble pour offrir une expérience IAP à votre client : PlayFab Economy v2 - Chronologie de l'échange Commencez par configurer vos ID de produit et vos prix au moyen de PlayMarket. Au départ, tous les produits sont sans visage : des entités numériques que votre joueur peut acheter, mais qui n’ont aucune signification pour les joueurs PlayFab. Pour rendre ces entités utiles, nous devons les refléter dans les catalogues d’articles PlayFab. PlayFab transforme les entités sans visage en lots, en conteneurs et en articles individuels. Chacun possède son propre visage unique, avec :
  • Titres
  • Descriptions
  • Étiquettes
  • Types
  • Images
  • Comportements
Tous les articles sont liés aux produits du marché par le partage d’ID. La meilleure façon d’accéder aux articles en argent réel offerts à l’achat est d’utiliser GetItems. L’ID de l’article constitue le lien entre PlayFab et tout système IAP externe. Nous transmettons donc l’ID de l’article au service IAP. À ce stade, le processus d’achat commence. Le joueur interagit avec l’interface IAP et, si l’achat réussit, vous obtenez un reçu. PlayFab valide le reçu et enregistre l’achat, en octroyant au joueur PlayFab les articles qu’il vient d’acheter.

Configuration d’une application cliente

Cette section vous montre comment configurer une application pour tester les IAP à l’aide de PlayFab, d’UnityIAP et de l’API Android Billing. Prérequis :
  • Un projet Unity.
  • Le SDK PlayFab pour Unity importé et configuré pour fonctionner avec votre titre.
  • Un éditeur comme Visual Studio installé et configuré pour fonctionner avec votre projet Unity.
Notre première étape consiste à configurer UnityIAP :
  1. Accédez à Services.
  2. Assurez-vous que l’onglet Services est sélectionné.
  3. Sélectionnez votre profil ou votre organisation Unity Services.
  4. Sélectionnez le bouton Create.
Configuration du service UnityIAP
  1. Ensuite, accédez au service In-App Purchasing (IAP).
Accéder au service UnityIAP
  1. Assurez-vous d’activer le Service en activant le bouton bascule Simplify cross-platform IAP.
  2. Sélectionnez ensuite le bouton Continue.
Activer le service UnityIAP Une page contenant une liste de plugiciels s’affiche.
  1. Sélectionnez le bouton Import.
Service UnityIAP - Importer les plugiciels Poursuivez l’installation d’Unity et la procédure d’importation jusqu’à ce que tous les plugiciels aient été importés.
  1. Vérifiez que les plugiciels sont en place.
  2. Créez ensuite un nouveau script, nommé AndroidIAPExample.cs.
UnityIAP - Créer un nouveau script AndroidIAPExample.cs contenant le code suivant (consultez les commentaires du code pour obtenir plus d’explications).
  1. Créez un nouveau GameObject nommé Code.
  2. Ajoutez-y le composant AndroidIAPExample (par glisser-déposer, ou autrement).
  3. Assurez-vous d’enregistrer la scène.
UnityIAP - Créer l'objet de jeu d'exemple Enfin, accédez à Build Settings.
  1. Vérifiez que votre scène a été ajoutée à la zone Scenes In Build.
  2. Assurez-vous que la plateforme Android est sélectionnée.
  3. Passez à la zone Player Settings.
  4. Attribuez votre Package Name.
Assurez-vous de choisir votre propre nom de package pour éviter tout conflit dans PlayMarket.
UnityIAP - Ajouter l'objet de jeu d'exemple Enfin, générez l’application comme d’habitude et assurez-vous d’obtenir un APK. Pour effectuer les tests, nous devons configurer PlayMarket et PlayFab.

Configuration d’une application PlayMarket pour les IAP

Cette section décrit en détail comment activer les IAP pour votre application PlayMarket.
La configuration de l’application elle-même dépasse la portée de ce tutoriel. Nous supposons que vous avez déjà une application et qu’elle est configurée pour publier au moins des versions Alpha.
Activer l'application PlayMarket Notes utiles :
  • Pour arriver à ce point, vous devez avoir téléversé un APK. Utilisez l’APK que nous avons créé dans la section précédente.
  • Téléversez l’APK en tant qu’application Alpha ou Bêta pour activer le bac à sable IAP.
  • La configuration de la classification du contenu comprend des questions sur la façon dont les IAP sont activés dans l’application.
  • PlayMarket ne permet pas aux éditeurs d’utiliser ou de tester les IAP. Choisissez un autre compte Google à des fins de test et ajoutez-le comme testeur pour votre version Alpha/Bêta.
  1. Publiez la version de l’application.
  2. Sélectionnez In-app products dans le menu.
    • Si on vous demande un compte marchand, liez-en un ou créez-en un.
  3. Sélectionnez le bouton Add New Product. PlayMarket - Ajouter un nouveau produit
  4. Dans l’écran du nouveau produit, sélectionnez Managed Product.
  5. Donnez-lui un ID de produit descriptif, comme 100diamonds.
  6. Sélectionnez Continue. PlayMarket - Ajouter l'ID du produit
  7. PlayMarket exige que vous remplissiez un titre (1) et une description (2), par exemple 100 Diamonds et A pack of 100 diamonds to spend in-game. Les données de l’article de données proviennent exclusivement du service PlayFab, et seuls les ID doivent correspondre. PlayMarket - Ajouter le titre et la description du produit
  8. Faites défiler plus bas et sélectionnez le bouton Add a price. PlayMarket - Ajouter le prix du produit
  9. Entrez un prix valide, comme « $0.99 » (remarquez que le prix est converti indépendamment pour chaque pays ou région).
  10. Sélectionnez le bouton Apply. PlayMarket - Appliquer les prix locaux du produit
  11. Enfin, remontez en haut de l’écran et changez l’état de l’article à Active. PlayMarket - Rendre le produit actif
  12. Enregistrez la clé de licence pour lier PlayFab à PlayMarket.
  13. Accédez à Services & APIs dans le menu.
  14. Repérez et enregistrez ensuite la version Base64 de la clé.
PlayMarket - Enregistrer la clé de licence du produit L’étape suivante consiste à activer les tests IAP. Bien que le bac à sable soit automatiquement activé pour les versions Alpha et Bêta, nous devons configurer les comptes autorisés à tester l’application :
  1. Accédez à Home.
  2. Repérez et sélectionnez Account details dans le menu de gauche.
  3. Repérez la zone License Testing.
  4. Vérifiez que vos comptes de test figurent dans la liste.
  5. Assurez-vous que License Test Response est défini à RESPOND_NORMALLY.
N’oubliez pas d’appliquer les paramètres! PlayMarket - Activer les tests IAP Le volet Play Market de l’intégration devrait maintenant être configuré.

Configuration d’un titre PlayFab

Notre dernière étape consiste à configurer un titre PlayFab pour refléter nos produits et l’intégrer à l’API Google Billing.
  1. Sélectionnez Add-ons.
  2. Sélectionnez ensuite le module complémentaire Google.
PlayFab - Ouvrir le module complémentaire Google
  1. Remplissez votre Package ID.
  2. Remplissez la Google App License Key que vous avez obtenue dans la section précédente.
  3. Validez vos modifications en sélectionnant le bouton Install Google.
Notre prochaine étape consiste à refléter notre lot de 100 diamants dans PlayFab :

Game Manager

  1. Créez une nouvelle monnaie dans le catalogue Economy (V2).
  2. Modifiez le titre et ajoutez une description, par exemple Diamonds, Our in-game currency of choice..
  3. Ajoutez un Friendly ID pour trouver plus facilement votre monnaie, diamonds.
  4. Sélectionnez Save and publish pour terminer vos modifications.
  5. Observez votre monnaie dans la liste Currency.
  6. Ensuite, créez un nouveau lot dans le catalogue Economy (V2).
  7. Modifiez le titre et ajoutez une description, par exemple 100 Diamonds Bundle, A pack of 100 diamonds to spend in-game..
Gardez à l’esprit que ces données n’ont rien à voir avec le titre et la description de l’article Play Market : elles en sont indépendantes.
  1. Vous pouvez utiliser le type de contenu pour organiser vos lots, par exemple appstorebundles. Les types de contenu sont gérés dans ⚙️ > Title Settings > Economy (V2).
  2. Suivez les prix réels en ajoutant des prix localisés aux propriétés d’affichage.
  3. Ajoutez un nouvel article au lot. Sélectionnez Currencies dans le filtre et choisissez la monnaie que vous avez créée à l’étape précédente. Définissez la quantité en fonction du montant de monnaie que vous souhaitez vendre dans ce lot.
  4. Ajoutez une nouvelle plateforme pour la marketplace « GooglePlay ». Si vous n’avez pas encore la marketplace GooglePlay, vous pouvez la créer dans la page Economy Settings. Définissez le Marketplace ID pour qu’il corresponde à l’ID de produit de la Google Play Console que vous avez créé dans la section précédente.
  5. Sélectionnez Save and publish pour terminer vos modifications.
  6. Observez votre lot dans la liste Bundles.

API REST


Ensuite, nous pouvons configurer des achats en jeu permettant aux joueurs de dépenser leur monnaie, avec une boutique PlayFab représentant un marchand PNJ en jeu :

Game Manager

  1. Créez un nouvel article dans le catalogue Economy (V2).
  2. Modifiez le titre et ajoutez une description, par exemple « Golden Sword », « A sword made of gold. ».
  3. Vous pouvez ajouter des mots clés localisés pour aider les joueurs à trouver votre article dans la boutique. Ajoutez des étiquettes et un type de contenu pour vous aider à organiser vos articles en vue de leur récupération ultérieure au moyen de l’API. Utilisez les propriétés d’affichage pour stocker des données de jeu, comme des valeurs d’armure, un chemin relatif vers des ressources graphiques ou toute autre donnée que vous devez stocker pour votre jeu.
  4. Ajoutez un nouveau prix et sélectionnez la monnaie que vous avez créée à l’étape précédente. Définissez le montant au prix que vous souhaitez par défaut. Vous pourrez remplacer le prix plus tard dans n’importe quelle boutique que vous créerez.
  5. Sélectionnez Save and publish pour terminer vos modifications.
  6. Observez votre article dans la liste Items.
  7. Enfin, créez une nouvelle boutique dans le catalogue Economy (V2).
  8. Modifiez le titre et ajoutez une description, par exemple Villager Store, A humble store run by a humble villager..
  9. Donnez-lui un Friendly ID pour faciliter la récupération, par exemple villagerstore.
  10. Ajoutez à la boutique l’article que vous avez créé à l’étape précédente. Vous pouvez ajouter plusieurs articles à une boutique et remplacer les prix par défaut au besoin.
  11. Sélectionnez Save and publish pour terminer vos modifications.
  12. Observez votre boutique dans la liste Stores.

API REST


Nous avons terminé la configuration de votre titre PlayFab.

Tests

À des fins de test, téléchargez l’application au moyen de la version Alpha/Bêta.
  • Assurez-vous d’utiliser un compte de test et un véritable appareil Android.
  • Une fois l’application démarrée, vous devriez voir que les IAP sont initialisés, ainsi qu’un bouton représentant votre article.
  • Sélectionnez ce bouton.
Application de test - Bouton d'achat de 100 diamants L’achat IAP est lancé. Suivez les instructions de Google Play jusqu’à ce que l’achat réussisse. Application de test - Google Play - Paiement réussi Enfin, accédez à votre titre dans le tableau de bord Game Manager de PlayFab et repérez New Events. Vérifiez que l’achat a été fourni, validé et acheminé vers l’écosystème PlayFab. Vous avez intégré avec succès UnityIAP et l’API Android Billing à votre application PlayFab!

Étapes suivantes

  1. Créez une interface d’achat avec Unity UI Toolkit pour remplacer l’affichage IMGUI de démonstration.
  2. Créez un enregistreur Unity personnalisé pour gérer les erreurs PlayFab et les afficher à l’utilisateur.
Last modified on October 6, 2026