Le SDK games v1 des services de jeux Google Play s'appuie 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 la version 1 des jeux jusqu'en 2025. La suppression de Google Sign-In entraîne 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épendance introduits par la suppression de Google Sign-In.
Ce document vous aide à comprendre les interactions entre l'application de jeu et les différents SDK. Ce document compare également les fonctionnalités de l'application à celles des SDK des jeux v1 et v2 des services de jeux Play.
Interactions avec le SDK
Les schémas illustrent l'interaction entre une application de jeu sur Android, le noyau des services Google Mobile (GMS), les services de jeux Play et un serveur de jeux tiers. Il met en évidence la façon dont 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.
jeux v2 (actuel)
games v1 (ancienne version)
Voici un bref aperçu des composants et des SDK:
- Application de jeux
- 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 chargé d'interagir avec les services de jeux Play.
- SDK Auth Le SDK Auth des services Google Play est chargé de gérer les 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 schéma 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 au jeu, telles que les classements, les succès 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 inter-processus (IPC).
- Passerelle des services de jeux Play
- Passerelle logique qui assure la médiation de la communication entre le GMS Core et le serveur Play Games Services.
- Gère les requêtes API, la transformation des données et l'authentification pour la communication du serveur.
- Serveur des services de jeux Play
- Représente les services backend des services de jeux Play chargés de stocker les données de jeu, de gérer les comptes utilisateur et de faciliter les fonctionnalités multijoueurs.
- Passerelle de jeux tiers
- Si votre application de jeu est considérée comme une application tierce, la bibliothèque cliente communique avec les serveurs des services de jeux Play via les serveurs de jeux tiers.
- Indique 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 jeu 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 tierce.
Comparatif des fonctionnalités
Ce tableau vous présente une comparaison des fonctionnalités entre les SDK games v1 et games v2:
Fonctionnalité |
SDK Jeux v1 |
SDK games v2 |
|---|---|---|
Authentification |
Intégration à play-services-auth requise. |
Simplifié et rationalisé, sans play-services-auth nécessaire. |
Autorisation |
Code supplémentaire pour les réussites, les échecs et les nouvelles tentatives. |
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. |
Les autorisations supplémentaires ne sont pas autorisées. Code supplémentaire avec un rappel de réussite/échec avec le code d'authentification du serveur. |
Procédure de connexion |
Utilise GoogleSigninClient.Code supplémentaire pour la gestion du code de modèle pour la connexion automatique et la gestion des erreurs. |
Utilise GamesSignInClient.Le SDK gère le code récurrent, la connexion automatique et la gestion des erreurs. |
Fenêtre pop-up de bienvenue |
Code supplémentaire requis. Les développeurs peuvent contrôler son emplacement et son timing. |
Aucun code supplémentaire requis Interface utilisateur cohérente pour tous les jeux configurés avec PGS V2. . |
Dépendances |
Nécessite play-services-auth. |
Aucune dépendance distincte sur play-services-auth. |
| Se déconnecter |
Utilise GoogleSignInClient.signOut. |
L'API de déconnexion n'est pas compatible. |
Plusieurs comptes Services de jeux Play et paramètres par jeu |
La sélection et la gestion des comptes ne sont pas disponibles. |
Pour chaque jeu, vous pouvez gérer votre compte Play Jeux. Vous pouvez ainsi sélectionner le compte utilisé par chaque jeu. |