Authentification de la plate-forme

La première étape pour intégrer votre jeu aux services de jeux Google Play (PGS) 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 la version 2 des services de jeux Play, 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 plate-forme. Ils gèrent 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 Play Games ne nécessitent pas de bouton Connexion manuel.
• ID de joueur : une fois l'authentification sur la plate-forme réussie, les services Play Games fournissent un ID de joueur stable. Cet ID est le même sur tous les appareils pour un même jeu. Utilisez-le principalement pour suivre les fonctionnalités de la plate-forme, comme la progression des succès.
• 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 Play Games 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 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 lorsqu'ils sont connectés à un IGA spécifique (par exemple, un compte invité ou un compte SiWG spécifique).
• Gestion de plusieurs identifiants de joueur en jeu : les services Play Games ne gèrent que l'authentification de la plate-forme. Votre jeu gère l'authentification principale des joueurs dans leurs identifiants de joueur en jeu. Cela signifie que les flux existants de votre jeu permettant aux joueurs de passer d'un identifiant de joueur en jeu à un autre ne sont pas modifiés. Lorsque les joueurs changent de compte, ils restent authentifiés sur la plate-forme Play Games via les services Play Games. Vous continuez à envoyer leurs données liées aux succès et à d'autres fonctionnalités des services Play Games par rapport à l'ID de joueur persistant.

Continuité multiplate-forme avec SiWG

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 la version 1 des services de jeux Play, 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 que les joueurs puissent s'authentifier et accéder à leur compte de jeu.
• SDK Connexion avec Google :
  • Pour Android et iOS, utilisez les SDK de connexion Google standards 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 Play Games 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 sur la plate-forme en initialisant le SDK des services Play Games 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 Play Games, telles que les succès et les classements.

L'authentification s'exécute en tant que processus silencieux en arrière-plan lors du lancement du jeu. Les utilisateurs existants des services Play Games voient un message de bienvenue après l'authentification. Les utilisateurs qui ne disposent pas d'un profil des services Play Games sont invités à créer un profil 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. Vous pouvez choisir l'expérience adaptée à vos utilisateurs en sélectionnant l'une des options suivantes :

Invites de création de profil déclenchées automatiquement

Par défaut, les invites de création de profil déclenchées automatiquement s'affichent automatiquement lorsque vous lancez un jeu sans profil Play Jeux.

Désactiver les invites de création de profil déclenchées automatiquement

Désactivez les invites de profil au lancement en configurant le fichier manifeste pour empêcher les invites déclenchées automatiquement. Cela permet aux utilisateurs sans profil de services de jeux Play de continuer à charger le jeu sans être invités à créer un profil de services de jeux Play.

Bien que les utilisateurs puissent se connecter avec n'importe quel fournisseur d'identité, vous devez afficher une invite de création de profil pour les encourager à s'authentifier avec l'authentification de la plate-forme Play Jeux. Affichez cette invite selon les besoins, mais assurez-vous qu'elle se produit avant que les utilisateurs ne progressent de manière significative dans des fonctionnalités telles que les succès et les classements.

Envisagez de déclencher l'invite de profil lors des moments recommandés suivants :

• après avoir terminé un tutoriel ;
• Lors d'un moment récompensé (par exemple, lorsque vous gagnez un match, collectez un objet rare ou atteignez une étape).
• Au moment de lancer une deuxième session.

Pour en savoir plus, consultez Empêcher la création automatique de profils (Java) et Empêcher la création automatique de profils (Unity).

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 :

1. S'il existe une session de jeu active sur l'appareil, permettez au joueur de reprendre sa session en cours.
2. Si aucune session de jeu active n'est présente :
   1. 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é.
   2. 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 un compte IGA ou se connecter à un compte 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'autorisation du serveur ou Récupérer les codes d'authentification du serveur.

Consignes relatives à l'expérience utilisateur pour un 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.

1. Au lancement, le SDK PGS s'initialise pour authentifier l'identité de la plate-forme de l'utilisateur (ID de joueur PGS).
2. 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.
3. 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.
4. 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'accès fluide.

1. 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.
2. Le jeu contourne 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, le cas échéant, 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.

1. Le joueur se déconnecte de l'IGA actuel, mais la connexion à la plate-forme Services de jeux Play reste active.
2. Lorsque le joueur se connecte avec un autre compte IGA, le jeu lie ce nouveau compte à l'ID de joueur PGS actuel en tant que dernier compte 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 au jeu d'implémenter la restauration fluide.

1. Au lancement, PGS authentifie l'utilisateur et fournit l'ID du joueur PGS au jeu.
2. 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.
3. 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.
4. Sinon, le jeu présente à l'utilisateur son écran de connexion.
   1. Le joueur choisit ensuite une méthode de connexion et se connecte à un IGA.
   2. Le jeu associe ensuite cet IGA à l'ID de joueur PGS en tant qu'IGA utilisé en dernier pour une restauration fluide.

Mode Invité

Les joueurs peuvent lancer votre jeu et y jouer à l'aide d'un compte invité local. Les services de jeux Play authentifient toujours le joueur en arrière-plan. Si le joueur sélectionne Enregistrer la progression, votre jeu convertit la session invité en IGA permanent et l'associe à l'ID du joueur. Pour en savoir plus sur la résolution des conflits, consultez Compte invité.