Migration de l'API vers le SDK

Si vos jeux natifs Google Play Jeux sur PC appellent directement les API Play Billing, vous devez migrer votre jeu pour qu'il utilise le SDK pour PC.

Selon le moteur de jeu que vous utilisez, vous pouvez intégrer C++ SDK ou C# SDK. Consultez les exemples de projets qui montrent comment migrer votre jeu natif vers le SDK.

Configuration et préparation

Cette section décrit les étapes de migration d'une solution basée sur une API vers le SDK natif Google Play Jeux sur PC.

Arguments de ligne de commande

Le SDK natif Google Play Jeux sur PC s'appuie sur certains arguments de ligne de commande transmis lors du démarrage du processus de votre jeu pour authentifier les utilisateurs. Ces arguments doivent être transmis au processus qui appelle Initialize SDK. Si le démarrage de votre jeu implique plusieurs processus, vous devez vérifier que tous les arguments sont transmis au processus qui utilise finalement le SDK. Consultez l'étape Assurer la compatibilité avec plusieurs processus de jeu de la configuration.

Mappage d'API

Pour finaliser la migration, vous devrez supprimer tous les appels d'API directs aux serveurs Play. Le SDK propose des appels de fonction correspondants pour obtenir la même fonctionnalité. Cette section liste le mappage pour chaque fonctionnalité.

Google Sign-In

Google Sign-In, également appelé Se connecter avec Google, est une méthode d'authentification OAuth qui permet aux utilisateurs de s'authentifier en un clic avec leur compte Google. Dans les projets basés sur les API, vous associez le compte d'un joueur à ses achats. Les solutions basées sur le SDK ne nécessitent pas cette association.

Les solutions basées sur le SDK utilisent le compte Google du client Google Play Jeux qui est déjà associé au profil de joueur et aux droits d'accès du joueur. Cela offre une expérience plus fluide aux joueurs et un environnement plus sécurisé aux développeurs, car le SDK peut communiquer de manière sécurisée avec le client Google Play Jeux via IPC.

Au lieu de Google Sign-In, appelez Initialize SDK dès que possible. Agissez en fonction du code d'erreur pour fournir un environnement sécurisé à l'exécution de votre jeu.

Obtenir la liste des produits

Dans la solution d'API, votre serveur de backend récupère la liste des produits à l'aide du point de terminaison inappproduct.gets de l'API Play Developer.

Dans le SDK, récupérez la liste des produits intégrés directement sur le client à l'aide de la fonction QueryProductDetails.

Générer des achats

Dans la solution d'API, votre serveur de backend récupère les achats des utilisateurs à l'aide du point de terminaison purchases.products.get de l'API Play Developer.

Dans le SDK, utilisez la fonction QueryPurchases directement depuis le client de votre jeu.

Lancer le parcours d'achat

Dans la solution API, le lancement du parcours d'achat nécessite d'appeler plusieurs points de terminaison pour la configuration et l'obtention des jetons nécessaires.

Dans le SDK, lancez le processus en appelant la fonction LaunchPurchaseFlow de BillingClient. Le SDK gère tout le travail nécessaire.

Traiter l'achat

Le traitement de l'achat de l'utilisateur implique la confirmation et la consommation de l'achat après avoir validé qu'il est légitime. Les solutions d'API et de SDK recommandent les étapes à suivre depuis votre backend pour des raisons de sécurité.

Le processus est similaire pour les solutions d'API et de SDK :

Après avoir récupéré le purchaseToken de l'achat, tel que ProductPurchase.purchaseToken dans la solution API ou purchase_token de ProductPurchaseDetails dans la solution SDK, envoyez-le à votre backend pour vérification.

Une fois l'achat vérifié, votre backend peut confirmer ou consommer l'achat de manière sécurisée après avoir accordé le droit d'accès.

Envoyer pour test

Pour envoyer votre jeu à des fins de test, procédez comme suit.

Package pour l'envoi

Les jeux utilisant le SDK doivent être empaquetés au format Windows App Bundle et importés via la Play Console. Consultez la documentation pour empaqueter votre jeu dans un app bundle Windows pour :