Présentation de la migration

Le SDK v1 des services de jeux Google Play repose sur la connexion Google pour Android, qui est obsolète et sera supprimée du SDK Auth des services Google Play (com.google.android.gms:play-services-auth) en 2025. Les nouvelles applications de jeux peuvent utiliser la version 1 des jeux jusqu'en 2025. La suppression de la connexion avec Google introduit des problèmes de dépendance pour les applications de jeux existantes. Migrer les applications de jeux existantes du SDK Games v1 vers le SDK Games v2 permet de résoudre les problèmes de dépendances introduits par la suppression de Google Sign-In.

Ce document vous aide à comprendre les interactions entre l'application Jeux et les différents SDK. Ce document compare également les fonctionnalités de l'application avec celles des SDK des services de jeux Play v1 et v2.

Interactions avec le SDK

Les schémas illustrent l'interaction entre une application de jeux sur Android, les services Google Mobile (GMS) Core, les services de jeux Play et un serveur de jeux tiers (3P). Il explique comment l'application utilise les services Google pour l'authentification et les fonctionnalités de jeu, tout en interagissant avec un système tiers distinct.

Voici un bref aperçu des composants et des SDK :

• Application de jeux.
  • Cela représente l'application de jeu de l'utilisateur exécutée sur un appareil Android.
  • Il comprend deux composants principaux :
    • SDK Games v1 ou Games v2 SDK côté client responsable de l'interaction avec les services de jeux Play.
    • SDK Auth Le SDK Auth des services Google Play est responsable de la gestion des flux d'authentification et d'autorisation des utilisateurs dans les jeux v1.
  • Les deux SDK communiquent à l'aide d'AIDL (Android Interface Definition Language), ce qui indique un modèle de communication entre différents processus ou services.
• GMS Core, également appelé Services Google Play.
  • Il s'agit de la couche propriétaire de Google sur Android.
  • L'application de jeux utilise deux modules GMS Core :
    • Le module Jeux fournit des fonctionnalités spécifiques aux jeux, telles que les classements, les réussites et la gestion de l'état du jeu.
    • Module d'authentification Gère les opérations d'authentification et d'autorisation des utilisateurs.
  • Les SDK Games et Auth de l'application de jeux communiquent avec les modules correspondants à l'aide d'interfaces AIDL, ce qui indique une communication entre processus (IPC).

• Passerelle des services de jeux Play.
  • Passerelle logique qui sert d'intermédiaire pour la communication entre le serveur des services Google Play et le serveur Play Jeux.
  • Gère les requêtes API, la transformation des données et l'authentification pour la communication avec le serveur.
• Serveur des services de jeux Play.
  • Représente les services de backend des services de jeux Play responsables du stockage des données de jeu, de la gestion des comptes utilisateur et de la facilitation des fonctionnalités multijoueurs.
• Passerelle de jeux tiers
  • Si votre application de jeux est considérée comme une application tierce (3P), la bibliothèque cliente communique avec les serveurs des services de jeux Play via les serveurs de jeux tiers.
  • Cela signifie que l'application peut également s'authentifier auprès d'un autre fournisseur de services.
• Serveur de jeu tiers
  • Représente un serveur externe facultatif avec lequel l'application de jeu peut interagir, probablement pour des fonctionnalités personnalisées ou la gestion des données.
  • La communication avec l'application se fait via la passerelle de jeux tiers.

Comparaison des fonctionnalités

Le tableau suivant compare les fonctionnalités des SDK Games v1 et Games v2 :

Fonctionnalité	SDK games v1	SDK Games v2
Authentification	L'intégration à play-services-auth est requise.	Simplifié et rationalisé ; aucun play-services-auth requis.
Autorisation	Code supplémentaire en cas de réussite, d'échec et de nouvelle tentative.	Géré par le SDK
Jeton d'accès au serveur	Peut demander des champs d'application OAuth 2.0 supplémentaires avec GoogleSigninClient. Code supplémentaire pour la gestion des erreurs lors de la connexion.	Peut demander trois habilitations d'identité OAuth 2.0 de base avec GamesSignInClient lors de la demande d'accès côté serveur aux API Web des services de jeux Play. Pour en savoir plus, consultez Accès côté serveur aux services de jeux Play et Récupérer les codes d'authentification du serveur.
Processus de connexion	Utilisations de GoogleSigninClient Code supplémentaire pour la gestion du code récurrent pour la connexion automatique et la gestion des erreurs.	Utilisations de GamesSignInClient Le SDK gère le code récurrent, la connexion automatique et la gestion des erreurs.
Pop-up de bienvenue	Du code supplémentaire est requis.  Les développeurs peuvent contrôler son emplacement et son timing.	Aucun code supplémentaire n'est requis. Interface utilisateur cohérente dans tous les jeux configurés avec le SDK v2 de Jeux.
Dépendances	Nécessite play-services-auth.	Le module Games s'occupe de l'autorisation et de l'authentification. Vous n'avez pas besoin d'ajouter de dépendances supplémentaires.
Se déconnecter	Utilisations de GoogleSignInClient.signOut.	L'API de déconnexion n'est pas compatible.
Plusieurs comptes Services de jeux Play et paramètres par jeu	La gestion de compte est possible dans votre jeu.	Les utilisateurs peuvent modifier le profil des services Play Jeux dans les paramètres de l'appareil mobile. Pour en savoir plus, consultez Changer de profil Play Jeux sur mobile.