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.
Avant de commencer
L’API Android Billing et PlayFab fonctionnent ensemble pour offrir une expérience IAP à votre client :
- Titres
- Descriptions
- Étiquettes
- Types
- Images
- Comportements
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.
- Accédez à Services.
- Assurez-vous que l’onglet Services est sélectionné.
- Sélectionnez votre profil ou votre organisation Unity Services.
- Sélectionnez le bouton Create.

- Ensuite, accédez au service In-App Purchasing (IAP).

- Assurez-vous d’activer le Service en activant le bouton bascule Simplify cross-platform IAP.
- Sélectionnez ensuite le bouton Continue.

- Sélectionnez le bouton Import.

- Vérifiez que les plugiciels sont en place.
- Créez ensuite un nouveau script, nommé AndroidIAPExample.cs.

AndroidIAPExample.cs contenant le code suivant (consultez les commentaires du code pour obtenir plus d’explications).
- Créez un nouveau GameObject nommé Code.
- Ajoutez-y le composant
AndroidIAPExample(par glisser-déposer, ou autrement). - Assurez-vous d’enregistrer la scène.

- Vérifiez que votre scène a été ajoutée à la zone Scenes In Build.
- Assurez-vous que la plateforme Android est sélectionnée.
- Passez à la zone Player Settings.
- Attribuez votre Package Name.
Assurez-vous de choisir votre propre nom de package pour éviter tout conflit dans PlayMarket.

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.

- 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.
- Publiez la version de l’application.
- Sélectionnez In-app products dans le menu.
- Si on vous demande un compte marchand, liez-en un ou créez-en un.
- Sélectionnez le bouton Add New Product.

- Dans l’écran du nouveau produit, sélectionnez Managed Product.
- Donnez-lui un ID de produit descriptif, comme
100diamonds. - Sélectionnez Continue.

- PlayMarket exige que vous remplissiez un titre (1) et une description (2), par exemple
100 DiamondsetA 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.
- Faites défiler plus bas et sélectionnez le bouton Add a price.

- Entrez un prix valide, comme « $0.99 » (remarquez que le prix est converti indépendamment pour chaque pays ou région).
- Sélectionnez le bouton Apply.

- Enfin, remontez en haut de l’écran et changez l’état de l’article à Active.

- Enregistrez la clé de licence pour lier PlayFab à PlayMarket.
- Accédez à Services & APIs dans le menu.
- Repérez et enregistrez ensuite la version Base64 de la clé.

- Accédez à Home.
- Repérez et sélectionnez Account details dans le menu de gauche.
- Repérez la zone License Testing.
- Vérifiez que vos comptes de test figurent dans la liste.
- Assurez-vous que License Test Response est défini à RESPOND_NORMALLY.

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.- Sélectionnez Add-ons.
- Sélectionnez ensuite le module complémentaire Google.

- Remplissez votre Package ID.
- Remplissez la Google App License Key que vous avez obtenue dans la section précédente.
- Validez vos modifications en sélectionnant le bouton Install Google.
Game Manager
- Créez une nouvelle monnaie dans le catalogue Economy (V2).
- Modifiez le titre et ajoutez une description, par exemple
Diamonds,Our in-game currency of choice.. - Ajoutez un Friendly ID pour trouver plus facilement votre monnaie,
diamonds. - Sélectionnez Save and publish pour terminer vos modifications.
- Observez votre monnaie dans la liste Currency.
- Ensuite, créez un nouveau lot dans le catalogue Economy (V2).
- 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.
- 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). - Suivez les prix réels en ajoutant des prix localisés aux propriétés d’affichage.
- 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.
- 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.
- Sélectionnez Save and publish pour terminer vos modifications.
- 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
- Créez un nouvel article dans le catalogue Economy (V2).
- Modifiez le titre et ajoutez une description, par exemple « Golden Sword », « A sword made of gold. ».
- 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.
- 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.
- Sélectionnez Save and publish pour terminer vos modifications.
- Observez votre article dans la liste Items.
- Enfin, créez une nouvelle boutique dans le catalogue Economy (V2).
- Modifiez le titre et ajoutez une description, par exemple
Villager Store,A humble store run by a humble villager.. - Donnez-lui un Friendly ID pour faciliter la récupération, par exemple
villagerstore. - 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.
- Sélectionnez Save and publish pour terminer vos modifications.
- 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.


Étapes suivantes
- Créez une interface d’achat avec Unity UI Toolkit pour remplacer l’affichage IMGUI de démonstration.
- Créez un enregistreur Unity personnalisé pour gérer les erreurs PlayFab et les afficher à l’utilisateur.
