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 !
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.
- Titres
- Descriptions
- Balises
- Types
- Images
- Comportements
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.
- Accédez à Services.
- Assurez-vous que l’onglet Services est sélectionné.
- Sélectionnez votre profil ou organisation Unity Services.
- Sélectionnez le bouton Create.

- Accédez ensuite au service In-App Purchasing (IAP).

- Veillez à 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 plug-ins sont en place.
- Créez ensuite un nouveau script, appelé AndroidIAPExample.cs.

AndroidIAPExample.cs contiendra le code présenté ci-dessous (veuillez vous reporter aux commentaires du code pour plus d’explications).
- Créez un nouvel objet Game appelé Code.
- Ajoutez-lui le composant
AndroidIAPExample(processus en 2 étapes). - Ajoutez-lui le composant
AndroidIAPExample. - Veillez à 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 a été sélectionnée.
- Passez à la zone Player Settings.
- Attribuez votre Package Name.
Veillez à choisir votre propre nom de package pour éviter tout conflit dans PlayMarket.

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.

- 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.
- Sélectionnez In-app products dans le menu.
- Si un Merchant Account vous est demandé, liez-en un ou créez-en un.
- Sélectionnez le bouton Add New Product.

- Sur l’écran présenté ci-dessous, sélectionnez Managed Product.
- Attribuez-lui un Product ID descriptif.
- Sélectionnez Continue.


- Faites défiler plus bas et sélectionnez le bouton Add a price.

- Saisissez un prix valide (notez que le prix est converti indépendamment pour chaque pays/région).
- Sélectionnez le bouton Apply.

- Enfin, revenez en haut de votre écran et modifiez l’état de l’objet sur Active.

- Accédez à Services & APIs dans le menu.
- Localisez et enregistrez ensuite la version Base64 de la Key.

- Accédez à Home.
- Localisez et sélectionnez Account details dans le menu de gauche.
- Localisez la zone License Testing.
- Vérifiez que vos Test Accounts figurent dans la liste.
- Assurez-vous que License Test Response est défini sur 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.

- Renseignez votre Package ID.
- Renseignez la Google App License Key obtenue dans la section précédente.
- Validez vos modifications en sélectionnant le bouton Install Google.

- Sélectionnez Economy.
- Vérifiez que le sous-onglet Catalogs est sélectionné.
- Sélectionnez New Catalog.
- Indiquez un nom de Catalog version.
- Sélectionnez Save Catalog.

- Sélectionnez l’objet pour modifier son Item ID afin qu’il corresponde à l’ID dans PlayMarket.
- 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.
- Attribuez un Price à votre Item.
- Sélectionnez Save Item pour valider vos modifications.

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.
- Observez votre objet dans la liste Item ID.

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.



