Le SDK v1 des services Google Play Games repose sur Google Sign-In pour Android, qui est obsolète et sera supprimé du
SDK Auth des services Google Play
(com.google.android.gms:play-services-auth) en 2025.
Les nouvelles applications de jeux peuvent utiliser le SDK v1 jusqu'en 2025. La suppression de Google Sign-In introduit des problèmes de dépendance pour les applications de jeux existantes. La migration des applications de jeux existantes
du SDK
jeux v1
vers le SDK jeux v2
résout les problèmes de dépendance introduits par la suppression de Google Sign-In.
Ce document vous aide à comprendre les interactions entre l'application de jeux et différents SDK. Il compare également les fonctionnalités de l'application avec celles des SDK v1 et v2 des services Play Jeux.
Interactions avec le SDK
Les schémas illustrent l'interaction entre une application de jeux sur Android, GMS Core, les services Play Games et un serveur de jeux tiers. Ils montrent comment l'application utilise les services de Google pour l'authentification et les fonctionnalités de jeu, tout en interagissant avec un système tiers distinct.
SDK v2 (actuel)
SDK v1 (hérité)
Voici un bref aperçu des composants et des SDK :
- Application de jeux
- Il s'agit de l'application de jeux de l'utilisateur qui s'exécute sur un appareil Android.
- Elle contient deux composants principaux :
- SDK v1 ou v2 SDK côté client responsable de l'interaction avec les services Play Games.
- SDK Auth Le SDK Auth des services Google Play est responsable de la gestion des flux d'authentification et d'autorisation des utilisateurs dans le SDK 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.
- Le module Auth gère les opérations d'authentification et d'autorisation des utilisateurs.
- Les SDK Jeux et Auth de l'application de jeux communiquent avec les modules correspondants à l'aide d' interfaces AIDL, ce qui indique une communication interprocessus (IPC).
- Passerelle des services de jeux Play
- Passerelle logique qui assure la médiation de la communication entre GMS Core et le serveur des services Play Games.
- Gère les requêtes API, la transformation des données et l'authentification pour la communication avec le serveur.
- Serveur des services Play Games
- Représente les services backend des services Play Jeux 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, la bibliothèque cliente communique avec les serveurs des services Play Games via les serveurs de jeux tiers.
- Cela implique que l'application peut également s'authentifier auprès d'un autre fournisseur de services.
- Serveur de jeux tiers
- Représente un serveur externe facultatif avec lequel l'application de jeux peut interagir, probablement pour des fonctionnalités personnalisées ou la gestion des données.
- La communication avec l'application s'effectue via la passerelle de jeux tiers.
Comparatif des fonctionnalités
Ce tableau compare les fonctionnalités des SDK v1 et v2 :
Fonctionnalité |
SDK v1 |
SDK v2 |
|---|---|---|
Authentification |
Intégration à play-services-auth requise. |
Simplifiée et rationalisée ; play-services-auth n'est pas requis. |
Autorisation |
Code supplémentaire pour les réussites, les échecs et les nouvelles tentatives. |
Gérée 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 exceptions lors de l'authentification. |
Peut demander trois champs d'application 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 Play Jeux et Récupérer les codes d'authentification du serveur. |
Processus de connexion |
Utilise GoogleSigninClient.Code supplémentaire pour la gestion du code récurrent pour l'authentification automatique et la gestion des exceptions. |
Utilise GamesSignInClient.Le SDK gère le code récurrent, l'authentification automatique et la gestion des erreurs. |
Pop-up de bienvenue |
Code supplémentaire 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. |
Dépendances |
Nécessite play-services-auth. |
Le module Jeux s'occupe de l'autorisation et de l'authentification. Vous n'avez pas besoin d'ajouter de dépendances supplémentaires. |
| Se déconnecter |
Utilise GoogleSignInClient.signOut. |
L'API de déconnexion n'est pas compatible. |
Plusieurs comptes services Play Jeux et paramètres par jeu |
La gestion des comptes est possible dans votre jeu. |
Les utilisateurs peuvent modifier le profil services Play Games dans les paramètres de l'appareil mobile Pour en savoir plus, consultez Changer de profil Play Jeux sur mobile. |