Migration de l'API vers le SDK

Si vos jeux natifs Google Play Jeux sur PC appellent directement les API Play Billing, vous devez les migrer pour utiliser le SDK PC.

Selon le moteur de jeu que vous utilisez, vous pouvez intégrer le C++ SDK ou le C# SDK. Consultez les exemples de projets qui illustrent les exemples pouvant être utilisés pour 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 le SDK d'initialisation. 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 Compatibilité avec plusieurs processus de jeu de la configuration.

Mappage d'API

Pour effectuer la migration, vous devez supprimer tous les appels d'API directs vers les serveurs Play. Il existe des appels de fonction correspondants dans le SDK pour obtenir la même fonctionnalité. Cette section répertorie 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 offre une option d'authentification en un clic pour les utilisateurs avec leur compte Google. Dans les projets basés sur une API, vous associez le compte d'un joueur à ses achats. Les solutions basées sur un SDK ne nécessitent pas cette association.

Les solutions basées sur un 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é pour l'exécution de votre jeu.

Obtenir la fiche produit

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

Dans le SDK, récupérez la fiche produit intégrée directement sur le client à l'aide de la QueryProductDetails fonction.

Obtenir les achats

Dans la solution d'API, votre serveur 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 QueryPurchases fonction directement depuis votre client de jeu.

Lancer le parcours d'achat

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

Dans le SDK, lancez le processus en appelant la fonction BillingClient's LaunchPurchaseFlow. Le SDK gère toutes les tâches nécessaires.

Traiter l'achat

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

Le processus est similaire pour la solution d'API et la solution de SDK :

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

Une fois la vérification effectuée, votre backend peut confirmer de manière sécurisée ou utiliser l'achat 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 Windows App Bundle pour :