Skip to main content

Bien démarrer avec Economy v2, Unity et Android

Economy v2 est désormais en disponibilité générale. Pour obtenir de l’aide et donner votre avis, rendez-vous sur le forum PlayFab.
Ce tutoriel vous montre comment configurer les achats intégrés à l’application (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 d'échange Commencez par configurer vos ID de produit et vos prix via PlayMarket. Au départ, tous les produits sont anonymes : il s’agit d’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 anonymes en bundles, en conteneurs et en articles individuels. Chacun possède sa propre identité, avec :
  • Titres
  • Descriptions
  • Balises
  • Types
  • Images
  • Comportements
Tous les articles sont liés aux produits de la place de marché par le partage d’ID. La meilleure façon d’accéder aux articles en argent réel disponibles à l’achat consiste à 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 tel que 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 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. Veillez à 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 plug-ins s’affiche.
  1. Sélectionnez le bouton Import.
Service UnityIAP - Importer les plug-ins Poursuivez la procédure d’installation et d’importation de Unity jusqu’à ce que tous les plug-ins aient été importés.
  1. Vérifiez que les plug-ins sont en place.
  2. Créez ensuite un nouveau script nommé AndroidIAPExample.cs.
UnityIAP - Créer un nouveau script AndroidIAPExample.cs contient le code suivant (reportez-vous aux commentaires du code pour plus d’explications).
  1. Créez un nouveau GameObject nommé Code.
  2. Ajoutez-y le composant AndroidIAPExample (par glisser-déplacer, ou).
  3. Veillez à 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.
Veillez à 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 de disposer d’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 le cadre de ce tutoriel. Nous partons du principe que vous disposez déjà d’une application configurée pour publier au moins des versions Alpha.
Activer l'application PlayMarket Remarques utiles :
  • Pour arriver à ce stade, vous devez avoir chargé un APK. Utilisez l’APK que nous avons généré dans la section précédente.
  • Chargez l’APK en tant qu’application Alpha ou Bêta pour activer le sandbox 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 en tant que testeur de votre build Alpha/Bêta.
  1. Publiez le build de l’application.
  2. Sélectionnez In-app products dans le menu.
    • Si un compte marchand vous est demandé, liez-en un ou créez-en un.
  3. Sélectionnez le bouton Add New Product. PlayMarket - Ajouter un nouveau produit
  4. Sur l’écran du nouveau produit, sélectionnez Managed Product.
  5. Attribuez-lui un ID de produit descriptif, tel que 100diamonds.
  6. Sélectionnez Continue. PlayMarket - Ajouter l'ID de produit
  7. PlayMarket vous demande de renseigner 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 la page et sélectionnez le bouton Add a price. PlayMarket - Ajouter le prix du produit
  9. Entrez un prix valide, par exemple « $0.99 » (notez que le prix est converti indépendamment pour chaque pays/région).
  10. Sélectionnez le bouton Apply. PlayMarket - Appliquer les prix locaux du produit
  11. Enfin, revenez en haut de l’écran et définissez l’état de l’article sur Active. PlayMarket - Activer le produit
  12. Enregistrez la clé de licence pour lier PlayFab à PlayMarket.
  13. Accédez à Services & APIs dans le menu.
  14. Localisez 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 sandbox soit automatiquement activé pour les builds Alpha et Bêta, nous devons configurer les comptes autorisés à tester l’application :
  1. Accédez à Home.
  2. Localisez et sélectionnez Account details dans le menu de gauche.
  3. Localisez 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 sur RESPOND_NORMALLY.
N’oubliez pas d’appliquer les paramètres ! PlayMarket - Activer les tests IAP La partie Play Market de l’intégration doit maintenant être configurée.

Configuration d’un titre PlayFab

Notre dernière étape consiste à configurer un titre PlayFab pour qu’il reflète nos produits et s’intègre à 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. Renseignez votre Package ID.
  2. Renseignez 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 étape suivante consiste à refléter notre bundle de 100 diamants dans PlayFab :

Game Manager

  1. Créez une nouvelle monnaie dans Economy Catalog (V2).
  2. Modifiez le titre et ajoutez une description, par exemple Diamonds, Our in-game currency of choice..
  3. Ajoutez un Friendly ID pour faciliter la recherche de votre monnaie, diamonds.
  4. Sélectionnez Save and publish pour finaliser vos modifications.
  5. Observez votre monnaie dans la liste Currency.
  6. Ensuite, créez un nouveau bundle dans Economy Catalog (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 bundles, 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 bundle. Sélectionnez Currencies dans le filtre et choisissez la monnaie que vous avez créée précédemment. Définissez la quantité en fonction du montant de monnaie que vous souhaitez vendre dans ce bundle.
  4. Ajoutez une nouvelle plateforme pour la place de marché « GooglePlay ». Si vous ne disposez pas encore de la place de marché GooglePlay, vous pouvez la créer dans la page Economy Settings. Définissez le Marketplace ID pour qu’il corresponde à l’ID de produit Google Play Console que vous avez créé dans la section précédente.
  5. Sélectionnez Save and publish pour finaliser vos modifications.
  6. Observez votre bundle dans la liste Bundles.

API REST


Ensuite, nous pouvons définir des achats en jeu sur lesquels les joueurs dépenseront leur monnaie, avec un magasin PlayFab représentant un marchand PNJ en jeu :

Game Manager

  1. Créez un nouvel article dans Economy Catalog (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 le magasin. Ajoutez des balises et un type de contenu pour vous aider à organiser vos articles en vue de leur récupération ultérieure via l’API. Utilisez les propriétés d’affichage pour stocker des données de jeu telles que 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 sur le prix que vous souhaitez appliquer par défaut. Vous pourrez remplacer le prix ultérieurement dans n’importe quel magasin que vous créerez.
  5. Sélectionnez Save and publish pour finaliser vos modifications.
  6. Observez votre article dans la liste Items.
  7. Enfin, créez un nouveau magasin dans Economy Catalog (V2).
  8. Modifiez le titre et ajoutez une description, par exemple Villager Store, A humble store run by a humble villager..
  9. Attribuez-lui un Friendly ID pour faciliter sa récupération, par exemple villagerstore.
  10. Ajoutez au magasin l’article que vous avez créé à l’étape précédente. Vous pouvez ajouter plusieurs articles à un magasin et remplacer les prix par défaut si nécessaire.
  11. Sélectionnez Save and publish pour finaliser vos modifications.
  12. Observez votre magasin dans la liste Stores.

API REST


La configuration de votre titre PlayFab est terminée.

Test

À des fins de test, téléchargez l’application à l’aide de la version Alpha/Bêta.
  • Veillez à utiliser un compte de test et un véritable appareil Android.
  • Une fois l’application démarrée, vous devez 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 localisez New Events. Vérifiez que l’achat a été fourni, validé et transmis à l’écosystème PlayFab. Vous avez intégré avec succès UnityIAP et l’API Android Billing dans votre application PlayFab !

Étapes suivantes

  1. Créez une interface Unity UI Toolkit pour les achats afin de 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