Authentification sur la plate-forme

La première étape de l'intégration de votre jeu aux services de jeux Google Play (PGS) consiste à implémenter l'authentification de la plate-forme. Cette étape 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 Play Games effectue automatiquement l'authentification de la plate-forme au lancement du jeu, vous devez intégrer le SDK des services Play Games 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 Games Level Up.

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 la plate-forme. Il gère la relation de votre lecteur 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 sur la plate-forme présente les caractéristiques clés suivantes :

  • Silencieuse et automatique : l'authentification s'effectue automatiquement en arrière-plan au lancement du jeu. Les services Play Games ne nécessitent pas de bouton Se connecter 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, telles que la progression des réussites.
  • 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 (IGA), la progression ou l'inventaire de votre joueur. 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 via l'authentification des services de jeux Play. L'intégration de votre client de jeu, l'intégration de votre 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 Play Games.

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 (IGA), qui est le système d'identité qui associe la progression, l'inventaire et la devise du joueur dans votre jeu.

  • Identité principale : vous pouvez utiliser votre propre backend, Se connecter avec Google (SIWG) ou d'autres fournisseurs comme méthode de connexion principale.
  • Indépendance : les joueurs peuvent se connecter aux services de jeux Play (identité de la plate-forme) pour remporter des succès tout en étant connectés à un compte IGA spécifique (par exemple, un compte invité ou un compte SiWG spécifique).
  • Gestion de plusieurs comptes de jeu : les services de jeux Play ne gèrent que l'authentification sur la plate-forme. Votre jeu gère l'authentification principale des joueurs dans leurs comptes de jeu. Cela signifie que les flux existants de votre jeu permettant aux joueurs de basculer entre leurs comptes de jeu instantané ne sont pas modifiés. Lorsque les joueurs changent de compte, ils restent authentifiés sur la plate-forme Play Jeux via les services Play Games, et vous continuez à envoyer leurs données liées aux réussites et à d'autres fonctionnalités des services Play Games à l'ID de joueur persistant.

Continuité multiplate-forme avec Se connecter 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 la v1 des services de jeux Google Play, le bouton Google Play gérait souvent la connexion à la plate-forme et au jeu. Dans la v2, il s'agit de processus distincts. Implémentez un bouton Se connecter avec Google standard pour que les joueurs puissent s'authentifier et accéder à leur compte IGA.
  • SDK Google Sign-In :
    • Pour Android et iOS, utilisez les SDK Google Sign-In standards pour authentifier les joueurs dans leurs comptes de jeu instantané.
    • Utilisez Google Open ID 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, telles que les réussites.

Intégration recommandée

Pour intégrer votre jeu aux services de jeux Play, suivez les étapes recommandées ci-dessous :

Initialisation et authentification

Cette étape est requise 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 requise pour accéder aux fonctionnalités des services Play Games, telles que les réussites et les classements.

L'authentification s'exécute en tant que processus en arrière-plan silencieux lors du lancement du jeu. Les utilisateurs existants des services de jeux Google Play voient un message de bienvenue une fois l'authentification réussie. Les utilisateurs qui n'ont pas de profil des services de jeux Play sont invités à en créer un lors de l'initialisation du SDK.

Invite de connexion automatique

Création du profil

Les joueurs ont besoin d'un profil services Play Games pour utiliser la plate-forme. Il est possible que certains joueurs n'aient pas de profil de services de jeux Play lorsqu'ils lancent votre jeu. Ces joueurs seront invités à en créer un. Vous pouvez choisir l'expérience la mieux adaptée à vos utilisateurs en sélectionnant l'une des options suivantes :

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

Les invites de création de profil à déclenchement automatique s'affichent automatiquement par défaut lorsque vous lancez un jeu sans profil de services Play Jeux.

Invite de création de profil lorsque vous lancez un jeu.
Invite de création de profil lorsque vous lancez un jeu (cliquez pour agrandir)

Arrêter 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 si nécessaire, mais assurez-vous qu'elle s'affiche avant que les utilisateurs ne progressent de manière significative dans des fonctionnalités telles que les réussites et les classements.

Nous vous recommandons de déclencher l'invite de profil aux moments suivants :

  • Après avoir terminé un tutoriel.
  • Lors d'un moment récompensé (par exemple, gagner un match, collecter un objet rare ou atteindre un jalon).
  • Au moment du lancement d'une deuxième session.

Pour en savoir plus, consultez Empêcher la création de profils déclenchée automatiquement (Java) et Empêcher la création de profils déclenchée automatiquement (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 que les joueurs puissent accéder à leurs comptes de jeu instantané, en fonction de l'état actuel du jeu :

  1. Si une session de jeu est active sur l'appareil, autorisez le joueur à reprendre sa session en cours.
  2. Si aucune session de jeu n'est active :
    1. Dans le cas d'un scénario de restauration fluide où un compte IGA auquel l'utilisateur a joué pour la dernière fois est associé à l'ID de joueur PGS, procédez à la restauration automatique du compte IGA associé.
    2. Sinon, présentez au joueur l'écran de connexion ou de création de compte 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 Play Games, 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 première fois sur un appareil sans historique de jeu préalable.

  1. Au lancement, le SDK PGS s'initialise pour authentifier l'identité de l'utilisateur sur la plate-forme (ID de joueur PGS).
  2. Après cette négociation en arrière-plan, le jeu affiche les options de création d'un compte IGA pour le joueur, par exemple Créer un compte, Se connecter avec Google ou d'autres méthodes de connexion via les réseaux sociaux.
  3. Une fois que le joueur a créé ou sélectionné un compte de jeu instantané, 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 joué pour une restauration fluide.
Nouveau joueur avec un profil PGS connecté
Nouveau joueur avec un profil PGS connecté (cliquez pour agrandir).
Nouveau joueur sans profil de services Play Games
Nouveau joueur sans profil PGS (cliquez pour agrandir).
Nouveau joueur avec un profil PGS connecté
Nouveau joueur avec un profil PGS connecté (cliquez pour agrandir).

Joueurs avec 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.

  1. Lorsque le joueur lance l'application, les services Play Games s'authentifient de manière silencieuse en arrière-plan, ce qui vous fournit l'ID du joueur pour suivre sa progression par rapport aux réussites et à d'autres fonctionnalités des services Play Games.
  2. Simultanément, le cas échéant, le jeu contourne les écrans de connexion et connecte immédiatement le joueur à sa session IGA active ou à la dernière IGA jouée associée à son ID de joueur, afin qu'il puisse reprendre le jeu immédiatement.
Lancez le jeu sur le même appareil avec le profil PGS connecté.
Lancez le jeu sur le même appareil avec le profil PGS connecté (cliquez pour agrandir).
Lancer le jeu sur le même appareil avec un profil PGS déconnecté
Lancez le jeu sur le même appareil avec un profil PGS déconnecté (cliquez pour agrandir).
Launch game on same device with no PGS profile
Lancer le jeu sur le même appareil sans profil PGS (cliquez pour agrandir)
Lancer le jeu sur un nouvel appareil avec un profil PGS connecté et un compte dans le jeu associé
Lancer le jeu sur un nouvel appareil avec un profil PGS connecté et un compte IGA associé (cliquez pour agrandir)
Lancer le jeu sur un nouvel appareil avec un profil PGS connecté et aucun IGA associé
Lancer le jeu sur un nouvel appareil avec un profil PGS connecté et aucun compte IGA associé (cliquez pour agrandir)
Lancer le jeu sur un nouvel appareil avec un profil de services de jeux Play déconnecté
Lancer le jeu sur un nouvel appareil avec un profil PGS déconnecté (cliquez pour agrandir)
Lancer le jeu sur un nouvel appareil sans profil de services de jeux Play
Lancer le jeu sur un nouvel appareil sans profil PGS (cliquez pour agrandir)

Joueurs changeant de compte

Ce flux se produit lorsqu'un joueur ayant une session active accède aux paramètres du jeu pour changer de compte. Par exemple, se 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 PGS reste active.
  2. Lorsque le joueur se connecte avec un autre IGA, le jeu associe ce nouveau compte à l'ID de joueur PGS actuel en tant que dernier IGA utilisé, uniquement pour une restauration fluide.
Passer à un compte Google instantané qui n'est associé à aucun profil de services de jeux Google Play
Passer à un compte Google d'entreprise non associé à un profil PGS (cliquez pour agrandir)
Passer à un compte IGA associé au même profil PGS connecté
Passer à un compte IGA associé au même profil PGS connecté (cliquez pour agrandir).
Passer à un compte de jeu associé à un autre profil PGS
Passer à un compte IGA associé à un autre profil PGS (cliquez pour agrandir)
Switching IGA with no PGS profile on device
Changement de compte Google d'un utilisateur sans profil PGS sur l'appareil (cliquez pour agrandir)
Changement de compte de jeu avec un profil PGS déconnecté
Changer de compte IGA avec un profil PGS déconnecté (cliquez pour agrandir)
Passer à un IGA qui n'existe pas
Passer à un IGA qui n'existe pas (cliquez pour agrandir)

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. Il est recommandé d'implémenter la restauration fluide dans le jeu.

  1. Au lancement, PGS authentifie l'utilisateur et fournit l'ID de joueur PGS au jeu.
  2. Le jeu vérifie son backend (ou le jeton de rappel récupéré si l'API Recall est utilisée) pour voir si un dernier compte de jeu utilisé 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 affiche l'écran de connexion.
    1. Le joueur choisit ensuite une méthode de connexion et se connecte à un compte IGA.
    2. Le jeu associe ensuite cet IGA à l'ID de joueur PGS en tant que dernier IGA joué pour une restauration fluide.
Joueur récurrent avec un profil PGS déconnecté
Joueur récurrent avec un profil PGS déconnecté (cliquez pour agrandir).
Joueur récurrent avec un profil PGS connecté et un compte dans le jeu associé
Joueur récurrent avec un profil PGS connecté et un compte IGA associé (cliquez pour agrandir).
Joueur de retour avec un profil PGS connecté et aucun compte dans le jeu associé
Joueur de retour connecté à son profil PGS et sans compte IGA associé (cliquez pour agrandir).
Joueur de retour sans profil de services de jeux Play
Joueur de retour sans profil PGS (cliquez pour agrandir).

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 un compte invité instantané permanent et l'associe à l'ID de joueur. Pour en savoir plus sur la résolution des conflits, consultez Compte invité.

Mode Invité : aucun IGA créé
Mode Invité : aucun groupe d'instances géré n'est créé (cliquez pour agrandir).
Mode Invité – IGA créé
Mode Invité : IGA créé (cliquez pour agrandir).

Tester votre jeu

Assurez-vous que votre jeu fonctionne comme prévu en le testant. Les tests que vous effectuez dépendent des fonctionnalités de votre jeu.

Voici une liste des tests courants à exécuter.

  1. Connexion réussie.

    1. La connexion automatique fonctionne. L'utilisateur doit être connecté aux services de jeux Play au lancement du jeu.

    2. Le pop-up de bienvenue s'affiche.

      Exemple de pop-up de bienvenue.
      Exemple de pop-up de bienvenue (cliquez pour agrandir)

    3. Les messages de journalisation réussis s'affichent. Exécutez la commande suivante dans le terminal :

      adb logcat | grep com.google.android.

      Voici un exemple de message de journal réussi :

      [$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc
      number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup.
      [CONTEXT service_id=1 ]
  2. Assurer la cohérence des composants d'interface utilisateur.

    1. Les pop-ups, les classements et les réussites s'affichent correctement et de manière cohérente sur différentes tailles et orientations d'écran dans l'interface utilisateur des services Play Games.

    2. L'option de déconnexion n'est pas visible dans l'interface utilisateur des services de jeux Play.

    3. Assurez-vous de pouvoir récupérer l'ID du joueur et, le cas échéant, que les fonctionnalités côté serveur fonctionnent comme prévu.

    4. Si le jeu utilise l'authentification côté serveur, testez minutieusement le flux requestServerSideAccess. Assurez-vous que le serveur reçoit le code d'authentification et peut l'échanger contre un jeton d'accès. Testez les scénarios de réussite et d'échec pour les erreurs réseau et les scénarios client ID non valides.

Si votre jeu utilisait l'une des fonctionnalités suivantes, testez-la pour vous assurer qu'elle fonctionne de la même manière qu'avant la migration :

  • Classements : envoyez des scores et consultez les classements. Vérifiez que le classement, les noms des joueurs et les scores s'affichent correctement.
  • Réussites : déverrouillez des réussites, puis vérifiez qu'elles sont correctement enregistrées et affichées dans l'interface utilisateur de Play Jeux.
  • Jeux enregistrés : si le jeu utilise des jeux enregistrés, assurez-vous que l'enregistrement et le chargement de la progression du jeu fonctionnent parfaitement. Il est particulièrement important de tester l'application sur plusieurs appareils et après les mises à jour.