La première étape de l'intégration de votre jeu aux services de jeux Google Play (SJGP) consiste à implémenter l'authentification de la plate-forme. Cette autorisation est requise pour accéder à toutes les autres fonctionnalités, telles que les réussites, les classements et les événements.
Étant donné que le SDK des services de jeux Play effectue automatiquement l'authentification de la plate-forme au lancement du jeu, vous devez intégrer le SDK des services de jeux Play v2 à votre jeu et implémenter le flux d'authentification recommandé. Votre jeu sera ainsi prêt à implémenter et à respecter les consignes relatives à l'expérience utilisateur de Google Play Jeux.
Concepts d'authentification
Dans les services de jeux Play v2, le concept de "connexion" est divisé en deux couches distinctes : l'authentification de la plate-forme et l'authentification dans le jeu.
Authentification sur la plate-forme
Les services de jeux Play fournissent une couche d'engagement de la plate-forme. Il gère la relation de votre joueur avec l'écosystème Google Play Jeux à l'aide du profil de joueur, pour accéder à des fonctionnalités telles que les réussites, les classements et les quêtes. L'authentification de la plate-forme présente les caractéristiques clés suivantes :
- Silencieuse et automatique : l'authentification se produit automatiquement en arrière-plan au lancement du jeu. Les services de jeux Play ne nécessitent pas de bouton Connexion manuel.
- ID de joueur : une fois l'authentification de la plate-forme réussie, les services de jeux Play fournissent un ID de joueur stable. Cet ID est le même sur tous les appareils pour un même jeu. Utilisez cet ID principalement pour suivre les fonctionnalités de la plate-forme, comme la progression des objectifs.
- Découplé : vous ne devez pas utiliser les services de jeux Play comme système d'identité principal de votre jeu pour gérer le compte de jeu de votre joueur, sa progression ou son inventaire. Les services de jeux Play servent d'identifiant de plate-forme persistant.
ID de joueur
Un ID de joueur est un identifiant associé à un compte de joueur pour les services de jeux Play. Votre jeu peut récupérer l'ID d'un joueur qui se connecte à votre jeu à l'aide de l'authentification des services de jeux Play. Votre intégration du client de jeu, votre intégration du serveur de jeu et votre service d'enregistrement dans le cloud peuvent utiliser l'ID pour accéder de manière sécurisée aux données du joueur depuis les services de jeux Play.
L'ID de joueur d'un utilisateur reste le même lorsqu'il joue à votre jeu sur plusieurs appareils. Cependant, il peut changer d'un jeu à l'autre. Pour en savoir plus, consultez ID de joueur de nouvelle génération.
Authentification dans le jeu
Vous gérez le compte de jeu, qui est le système d'identité qui lie la progression, l'inventaire et la devise du joueur dans votre jeu.
- Identité principale : vous pouvez utiliser votre propre backend, Se connecter avec Google (SCWG) ou d'autres fournisseurs comme méthode de connexion principale.
- Indépendance : les joueurs peuvent se connecter aux services de jeux Play (identité de plate-forme) pour gagner des succès tout en étant connectés à n'importe quel IGA spécifique (par exemple, un compte invité ou un compte SiWG spécifique).
- Gestion de plusieurs IGA : les services de jeux Play ne gèrent que l'authentification de la plate-forme. Votre jeu gère l'authentification principale des joueurs dans leurs comptes IGA. Cela signifie que les flux existants de votre jeu permettant aux joueurs de passer d'une IAP à l'autre ne changent pas. Lorsque les joueurs changent de compte, ils restent authentifiés sur la plate-forme Play Jeux via PGS. Vous continuez à envoyer leurs données liées aux succès et à d'autres fonctionnalités PGS par rapport à l'ID de joueur persistant.
Continuité multiplate-forme avec S'abonner avec Google
Pour aider les joueurs à conserver leur progression sur Android, iOS et le Web, utilisez Se connecter avec Google comme méthode d'authentification principale dans le jeu. Réfléchissez aux éléments suivants :
- Bouton "Se connecter avec Google" : dans PGS v1, le bouton Google Play gérait souvent la connexion à la plate-forme et au jeu. Dans la version 2, il s'agit de processus distincts. Implémentez un bouton standard Se connecter avec Google pour permettre aux joueurs de s'authentifier et d'accéder à leur IGA.
- SDK Connexion avec Google :
- Pour Android et iOS, utilisez les SDK standards de connexion Google pour authentifier les joueurs dans leurs comptes IGA.
- Utilisez Google OpenID comme identifiant principal pour le compte d'un joueur dans le jeu.
- Utilisez l'ID de joueur des services de jeux Play pour signaler la progression d'un joueur dans les fonctionnalités Play Jeux, comme les succès.
Intégration recommandée
Pour intégrer votre jeu aux services de jeux Play, suivez ces étapes recommandées :
Initialisation et authentification
Cette étape est nécessaire pour initialiser et authentifier votre jeu :
Implémentez l'authentification de la plate-forme en initialisant le SDK des services de jeux Play v2 au démarrage. Pour en savoir plus, consultez Authentification sur la plate-forme pour les jeux Android. Cette étape est nécessaire pour accéder aux fonctionnalités des services de jeux Play, telles que les réussites et les classements.
L'authentification s'exécute en tant que processus d'arrière-plan silencieux lors du lancement du jeu. Les utilisateurs existants des services de jeux Play voient un message de bienvenue une fois l'authentification réussie. Les utilisateurs qui ne possèdent pas de profil Services de jeux Play sont invités à en créer un lors de l'initialisation du SDK.
Création du profil
Les joueurs ont besoin d'un profil Services de jeux Play pour interagir avec la plate-forme. Il est possible que certains joueurs n'aient pas de profil Services de jeux Play lorsqu'ils commencent à jouer à votre jeu. Ces joueurs seront invités à en créer un.
Par défaut, les invites de création de profil déclenchées automatiquement s'affichent lorsque vous lancez un jeu sans profil Play Jeux.
Authentification dans le jeu
Une fois l'authentification de la plate-forme effectuée, les développeurs doivent suivre les étapes ci-dessous pour permettre aux joueurs d'accéder à leurs achats via l'application, en fonction de l'état actuel du jeu :
- S'il existe une session de jeu active sur l'appareil, permettez au joueur de reprendre sa session en cours.
- Si aucune session de jeu active n'est présente :
- Dans le cas d'un scénario de restauration fluide où un IGA joué en dernier est associé à l'ID de joueur PGS, procédez à la restauration automatique de l'IGA associé.
- Sinon, présentez au joueur l'écran de connexion ou de création de compte désigné de votre application. Les joueurs peuvent ensuite choisir leur méthode d'authentification préférée pour créer ou se connecter à un compte IGA existant.
Champs d'application OAuth
Les services de jeux Play s'appuient sur le système OAuth pour permettre aux joueurs d'autoriser votre jeu à accéder à leur compte. Les services de jeux Play disposent d'un champ d'application unique pour les jeux (games-lite) et s'appuient sur un autre champ d'application (drive.appdata) si votre jeu utilise la fonctionnalité Jeux enregistrés. La fonctionnalité Jeux enregistrés donne accès au compte Google Drive de l'utilisateur, où sont stockées les données de jeu.
Lorsque vous utilisez la version 2 du SDK des services de jeux Play, vous pouvez demander des champs d'application OAuth supplémentaires.
Si vous avez besoin de champs d'application OAuth supplémentaires, nous vous recommandons d'appeler requestServerSideAccess.
Pour en savoir plus, consultez Obtenir le code d'authentification du serveur ou Récupérer les codes d'authentification du serveur.
Consignes relatives à l'expérience utilisateur pour le flux d'authentification idéal
Les consignes suivantes expliquent le flux d'authentification recommandé avec l'intégration de PGS v2. Ils couvrent les scénarios pour les utilisateurs nouveaux, existants et connus, ainsi que le mode Invité.
Nouveau joueur
Ce flux s'applique à un utilisateur qui lance le jeu pour la toute première fois sur un appareil sans historique de jeu.
- Au lancement, le SDK PGS s'initialise pour authentifier l'identité de la plate-forme de l'utilisateur (ID de joueur PGS).
- Après cette prise de contact en arrière-plan, le jeu affiche les options de création d'un IGA au joueur, par exemple Créer un compte, Se connecter avec Google ou d'autres méthodes de connexion sociale.
- Une fois que le joueur a créé ou sélectionné un compte IGA, le jeu associe ce compte à l'identifiant principal choisi dans son backend.
- Le jeu associe également cet IGA choisi à l'ID de joueur PGS, en le marquant comme le dernier IGA utilisé pour la restauration fluide.
Joueurs ayant des sessions actives
Ce scénario décrit les joueurs qui lancent le jeu sur un appareil sur lequel ils ont déjà une session active. L'objectif est de proposer une expérience d'entrée fluide.
- Lorsque le joueur lance l'application, PGS s'authentifie silencieusement en arrière-plan, ce qui vous fournit un ID de joueur pour suivre la progression par rapport aux succès et à d'autres fonctionnalités Play Jeux.
- Le cas échéant, le jeu ignore les écrans de connexion et connecte immédiatement le joueur à sa session IGA active ou à la dernière session IGA associée à son ID de joueur, afin qu'il puisse reprendre le jeu immédiatement.
Joueurs changeant de compte
Ce flux se produit lorsqu'un joueur avec une session active accède aux paramètres du jeu pour changer de compte. Par exemple, vous pouvez vous déconnecter d'un compte principal pour utiliser un autre compte.
- Le joueur se déconnecte de l'IGA actuel, mais la connexion à la plate-forme Services de jeux Play reste active.
- Lorsque le joueur se connecte avec un autre IGA, le jeu lie ce nouveau compte à l'ID de joueur PGS actuel en tant que dernier IGA utilisé uniquement pour une restauration fluide.
Restauration fluide pour les anciens joueurs
Ce scénario s'applique lorsqu'un joueur lance le jeu après une période d'inactivité, une réinstallation ou sur un tout nouvel appareil. Nous recommandons aux développeurs de jeux d'implémenter la restauration fluide.
- Au lancement, PGS authentifie l'utilisateur et fournit l'ID du joueur PGS au jeu.
- Le jeu vérifie son backend (ou le jeton de rappel récupéré s'il utilise l'API Recall) pour voir si un compte IGA utilisé en dernier est déjà associé à cet ID PGS.
- Si un lien est trouvé, le jeu restaure automatiquement la progression du joueur et le connecte, en ignorant complètement l'écran de connexion manuelle.
- Sinon, le jeu présente l'écran de connexion au joueur.
- Le joueur choisit ensuite une méthode de connexion et se connecte à un IGA.
- Le jeu associe ensuite cet IGA à l'ID de joueur PGS en tant que dernier IGA utilisé pour une restauration fluide.
Mode Invité
Les joueurs peuvent lancer le jeu et y jouer avec un compte invité local. PGS s'authentifie toujours en arrière-plan. Si le joueur choisit d'enregistrer sa progression, le jeu convertit la session invité en IGA permanent et l'associe à l'ID de joueur PGS.
