Passer au contenu principal

Prise en main de PlayFab (Economy hérité), Unity IAP et Android

Les API Economy v1 sont en mode maintenance et ne recevront plus de nouvelles fonctionnalités, uniquement 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 coopérer. L’image suivante illustre comment l’API Android Billing et PlayFab fonctionnent ensemble pour offrir une expérience d’achat intégré solide à votre client. Android Billing - PlayFab - chronologie de l'intégration Commencez par configurer vos ID de produit et vos prix via 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 refléter dans les catalogues d’objets PlayFab. Cela transforme les entités anonymes en lots, en conteneurs et en objets individuels. Chacun possède sa propre identité, avec :
  • Titres
  • Descriptions
  • Balises
  • Types
  • Images
  • Comportements
Tous ces éléments sont liés aux produits du marché par le partage d’ID. La meilleure façon d’accéder aux objets en argent réel disponibles à l’achat consiste à 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’objet constitue le lien entre PlayFab et tout système d’achat intégré externe. Nous transmettons donc l’ID de l’objet 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 peut alors valider le reçu et enregistrer l’achat, en accordant au joueur PlayFab les objets qu’il vient d’acheter. Voici 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.

Configuration d’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, d’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 organisation Unity Services.
  4. Sélectionnez le bouton Create.
Configuration du service UnityIAP
  1. Accédez ensuite 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 d’Unity jusqu’à ce que tous les plug-ins soient importés.
  1. Vérifiez que les plug-ins 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 vous reporter aux commentaires du code pour plus d’explications).
  1. Créez un nouvel objet Game appelé Code.
  2. Ajoutez-lui le composant AndroidIAPExample (processus en 2 étapes).
  3. Ajoutez-lui le composant AndroidIAPExample.
  4. 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 a été 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 sain et sauf. Nous n’avons pas encore les moyens de le tester. Nous devons d’abord configurer PlayMarket et PlayFab, comme décrit dans les sections suivantes.

Configuration d’une application PlayMarket pour les achats intégrés

Cette section décrit les spécificités de l’activation des achats intégrés pour votre application PlayMarket.
La configuration de l’application elle-même dépasse le cadre de ce tutoriel. Nous supposons que vous disposez déjà d’une application, et qu’elle est configurée pour publier au moins des versions Alpha.
Activer l'application PlayMarket Remarques utiles :
  • Pour arriver à ce stade, vous devrez avoir chargé un APK. Veuillez utiliser l’APK que nous avons créé dans la section précédente.
  • Lorsque vous êtes invité à charger l’APK, vous pouvez le charger 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 achats intégrés sont activés dans l’application.
  • PlayMarket ne permet pas aux éditeurs d’utiliser ou de tester les achats intégrés ; veuillez donc choisir un autre compte Google à des fins de test, et l’ajouter comme testeur pour votre build Alpha/Bêta.
Une fois le build de l’application publié :
  1. Sélectionnez In-app products dans le menu.
    • Si un Merchant Account vous est demandé, liez-en un ou créez-en un.
  2. Sélectionnez le bouton Add New Product.
PlayMarket - Ajouter un nouveau produit
  1. Sur l’écran présenté ci-dessous, sélectionnez Managed Product.
  2. Attribuez-lui un Product ID descriptif.
  3. Sélectionnez Continue.
PlayMarket - Ajouter un ID de produit PlayMarket vous demande de renseigner un Title (1) et une Description (2). Cependant, ils ne nous sont pas très utiles dans notre cas. Nous récupérerons les données 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 plus bas et sélectionnez le bouton Add a price.
PlayMarket - Ajouter le prix du produit
  1. Saisissez un prix valide (notez que le prix est converti indépendamment pour chaque pays/région).
  2. Sélectionnez le bouton Apply.
PlayMarket - Appliquer les prix locaux du produit
  1. Enfin, revenez en haut de votre écran et modifiez l’état de l’objet sur Active.
PlayMarket - Activer le produit Bien que cela conclue la configuration de l’application, quelques ajustements supplémentaires sont nécessaires. Tout d’abord, enregistrons la Licensing Key (elle sera utile pour lier PlayFab à PlayMarket).
  1. Accédez à Services & APIs dans le menu.
  2. Localisez 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 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 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 IAP La partie Play Market de l’intégration devrait maintenant être configurée.

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. Renseignez votre Package ID.
  2. Renseignez la Google App License Key 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 étape suivante consiste à refléter notre objet 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 objet, il est automatiquement supprimé. C’est pourquoi tout nouveau catalogue est fourni avec un objet préajouté appelé One. Nous pouvons toujours créer un nouvel objet, mais pour garder les choses propres, modifions l’objet One existant.
  1. Sélectionnez l’objet pour modifier son Item ID afin qu’il corresponde à l’ID dans PlayMarket.
  2. Modifiez maintenant le Display name et ajoutez une Description.
N’oubliez pas que ces données n’ont rien à voir avec le titre et la description de l’objet Play Market : elles sont totalement indépendantes.
  1. Attribuez un Price à votre Item.
  2. Sélectionnez Save Item pour valider vos modifications.
PlayFab - Modifier et enregistrer l'objet de catalogue
Dans ce tutoriel, les achats intégrés désignent principalement des achats en argent réel. C’est pourquoi nous utilisons RM, la devise spéciale Real Money. Le montant PlayFab est défini en cents américains.
  1. Observez votre objet dans la liste Item ID.
PlayFab - Liste des objets 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.
  • Veillez à utiliser un compte de test et un véritable appareil Android.
  • Une fois l’application démarrée, vous devriez voir que les achats intégrés sont initialisés, ainsi qu’un bouton représentant votre objet.
  • Sélectionnez ce bouton.
Application de test - Bouton Buy Golden Sword L’achat intégré 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 PlayFab Game Manager et localisez New Events. Tableau de bord Game Manager - nouveaux événements Cela signifie que l’achat a bien été fourni, validé et transmis à l’écosystème PlayFab. À ce stade, vous avez intégré avec succès UnityIAP et l’API Android Billing dans votre application PlayFab.
Dernière modification le 6 octobre 2026