Passer au contenu principal

Premiers pas avec PlayFab (Economy hérité), Unity IAP et Android

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!
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

La configuration des achats intégrés peut être fastidieuse, surtout si vous ne savez pas exactement comment les différents services sont censés s’intégrer et collaborer. L’image suivante illustre comment l’API Android Billing et PlayFab fonctionnent ensemble pour offrir une expérience d’achats intégrés solide à votre client. Android Billing - PlayFab - chronologie de l'intégration Commencez par configurer vos Product IDs et vos Prices au moyen de PlayMarket. Au départ, tous les produits sont anonymes : ce sont des entités numériques que votre joueur peut acheter, mais elles n’ont aucune signification pour les joueurs PlayFab. Pour rendre ces entités utiles, nous devons les reproduire dans les catalogues d’articles PlayFab. Cela transforme les entités anonymes en ensembles, en conteneurs et en articles individuels. Chacun possède sa propre identité, avec :
  • des titres
  • des descriptions
  • des étiquettes
  • des types
  • des images
  • des comportements
Tous ces éléments sont liés aux produits du marché au moyen d’ID partagés. La meilleure façon d’accéder aux articles en argent réel offerts à l’achat est d’utiliser GetCatalogItems et GetStoreItems. Ce sont les mêmes méthodes d’API que celles utilisées par les boutiques en monnaie gratuite; le processus devrait donc vous être familier. L’ID de l’article est le lien entre PlayFab et tout système d’achats intégrés externe. Nous transmettons donc l’ID de l’article au service d’achats intégrés. À ce stade, le processus d’achat commence. Le joueur interagit avec l’interface d’achats intégrés et, si l’achat réussit, vous obtenez un reçu. PlayFab peut ensuite valider le reçu et enregistrer l’achat, en accordant au joueur PlayFab les articles qu’il vient d’acheter. Voilà une idée générale du fonctionnement de l’intégration des achats intégrés, et l’exemple suivant en montre la majeure partie en action.

Configurer une application cliente

Cette section vous montre comment configurer une application très simple pour tester les achats intégrés à l’aide de PlayFab, de UnityIAP et de l’API Android Billing. Prérequis :
  • Un projet Unity.
  • Le SDK PlayFab importé et configuré pour fonctionner avec votre titre.
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 la procédure d’installation et d’importation de Unity jusqu’à ce que tous les plugiciels soient importés.
  1. Vérifiez que les plugiciels sont en place.
  2. Créez ensuite un nouveau script appelé AndroidIAPExample.cs.
UnityIAP - Créer un nouveau script AndroidIAPExample.cs contiendra le code présenté ci-dessous (veuillez consulter les commentaires du code pour obtenir plus d’explications).
  1. Créez un nouvel objet Game appelé Code.
  2. Ajoutez-y le composant AndroidIAPExample (processus en 2 étapes).
  3. Ajoutez-y le composant AndroidIAPExample.
  4. Assurez-vous d’enregistrer (Save) 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’avoir un APK en lieu sûr. Nous n’avons pas encore de moyen de le tester. Nous devons d’abord configurer PlayMarket et PlayFab, comme le décrivent les sections suivantes.

Configurer une application PlayMarket pour les achats intégrés

Cette section décrit les détails de l’activation des achats intégrés 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 Remarques utiles :
  • Pour arriver à ce point, vous devrez avoir téléversé un APK. Veuillez utiliser l’APK que nous avons créé dans la section précédente.
  • Lorsqu’on vous demande de téléverser l’APK, vous pouvez le téléverser en tant qu’application Alpha ou Bêta pour activer le bac à sable des achats intégrés.
  • La configuration de la Content Rating comprendra des questions sur la façon dont les achats intégrés sont activés dans l’application.
  • PlayMarket ne permet pas aux éditeurs d’utiliser ni de tester les achats intégrés; veuillez donc choisir un autre compte Google à des fins de test, et l’ajouter comme testeur de votre version Alpha/Bêta.
Une fois la version de l’application publiée :
  1. Sélectionnez In-app products dans le menu.
    • Si on vous demande un Merchant Account, liez-en un ou créez-en un.
  2. Sélectionnez le bouton Add New Product.
PlayMarket - Ajouter un nouveau produit
  1. Dans l’écran présenté ci-dessous, sélectionnez Managed Product.
  2. Donnez-lui un Product ID descriptif.
  3. Sélectionnez Continue.
PlayMarket - Ajouter l'ID de produit PlayMarket exige que vous remplissiez un Title (1) et une Description (2). Toutefois, ceux-ci ne sont pas très utiles dans notre cas. Nous obtiendrons les données des Data Item exclusivement à partir du service PlayFab, et nous avons seulement besoin que les ID correspondent. PlayMarket - Ajouter le titre et la description du produit
  1. Faites défiler vers le bas et sélectionnez le bouton Add a price.
PlayMarket - Ajouter le prix du produit
  1. Entrez un prix valide (remarquez comment le prix est converti indépendamment pour chaque pays ou région).
  2. Sélectionnez le bouton Apply.
PlayMarket - Appliquer les prix locaux du produit
  1. Enfin, remontez en haut de l’écran et changez l’état de l’article à Active.
PlayMarket - Activer le produit Bien que cela conclue la configuration de l’application, nous devons apporter quelques ajustements supplémentaires. D’abord, enregistrons la Licensing Key (elle sera utile pour lier PlayFab à PlayMarket).
  1. Accédez à Services & APIs dans le menu.
  2. Repérez et enregistrez ensuite la version Base64 de la Key.
PlayMarket - Enregistrer la clé de licence du produit L’étape suivante consiste à activer les tests d’achats intégrés. 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 Test Accounts 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 d'achats intégrés Le volet Play Market de l’intégration devrait maintenant être configuré.

Configurer 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. Entrez votre Package ID.
  2. Entrez 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.
PlayFab - Installer le module complémentaire Google Notre prochaine étape consiste à reproduire notre article Golden Sword dans PlayFab :
  1. Sélectionnez Economy.
  2. Vérifiez que le sous-onglet Catalogs est sélectionné.
  3. Sélectionnez New Catalog.
  4. Indiquez un nom de Catalog version.
  5. Sélectionnez Save Catalog.
PlayFab - Enregistrer le catalogue Si le catalogue ne contient aucun article, il est automatiquement supprimé. C’est pourquoi tout nouveau catalogue est fourni avec un article préajouté appelé One. Nous pouvons toujours créer un nouvel article, mais pour garder les choses simples, modifions l’article One existant.
  1. Sélectionnez l’article pour modifier l’Item ID afin qu’il corresponde à l’ID dans PlayMarket.
  2. Modifiez maintenant le Display name et ajoutez une Description.
Gardez à l’esprit que ces données n’ont rien à voir avec le Play Market Item Title et la Description; elles en sont totalement indépendantes.
  1. Attribuez un Price à votre Item.
  2. Sélectionnez Save Item pour valider vos modifications.
PlayFab - Modifier et enregistrer l'article de catalogue
Dans ce tutoriel, les achats intégrés désignent principalement les achats en argent réel. C’est pourquoi nous utilisons RM, la monnaie spéciale Real Money (argent réel). Le montant PlayFab est défini en cents américains.
  1. Observez votre article dans la liste Item ID.
PlayFab - Liste des articles du catalogue Cela conclut la configuration de votre titre PlayFab.

Test

À des fins de test, téléchargez l’application à l’aide 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 les achats intégrés initialisés et un bouton représentant votre article.
  • Sélectionnez ce bouton.
Application de test - Bouton Buy Golden Sword L’achat intégré est alors 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 de PlayFab Game Manager et repérez les New Events. Tableau de bord Game Manager - Nouveaux événements Cela signifie que l’achat a été fourni, validé et acheminé avec succès vers l’écosystème PlayFab. Vous avez maintenant intégré avec succès UnityIAP et l’API Android Billing à votre application PlayFab.
Dernière modification le 6 octobre 2026