Connexion

La fonctionnalité de connexion aux services de jeux Play vous permet d'obtenir l'identité de jeu d'un joueur. Cette identité de joueur Android est spécifique au jeu au niveau de la plate-forme. Elle permet d'établir une relation entre votre jeu et le joueur. Les joueurs acceptent plus volontiers d'utiliser cette identité pour se connecter que d'autres systèmes centralisés.

De plus, la fonctionnalité de connexion vous fournit un identifiant fort et cohérent que vous pouvez utiliser comme clé d'accès à un système d'enregistrement dans le cloud. Très apprécié des joueurs, l'enregistrement dans le cloud leur permet d'effectuer ce qui suit :

  • Reprendre le jeu là où ils l'ont interrompu s'ils réinitialisent leur appareil ou en changent
  • Utiliser le jeu sur plusieurs appareils (par exemple, sur un autre téléphone ou sur un Chromebook)
  • Désinstaller le jeu et le réinstaller ultérieurement

Vous pouvez utiliser l'identité des services de jeux Play comme clé pour votre propre solution d'enregistrement dans le cloud, ou vous pouvez utiliser le service Jeux enregistrés accessible sans frais.

Les services de jeux Play (PGS) prennent en charge la connexion automatique, une manière simple de connecter les joueurs, ainsi que la connexion manuelle, qui est un processus en un clic. Ce décrit ces différentes méthodes de connexion.

Flux de connexion recommandé

Pour connecter les joueurs à votre jeu, utilisez le flux de connexion suivant :

  1. Pendant la séquence de démarrage de votre jeu, essayez de se connecter automatiquement. pour connecter automatiquement le joueur.
  2. Si la connexion automatique ne fonctionne pas et que l'appareil de l'utilisateur est en ligne, essayez la connexion manuelle.
  3. Si la connexion manuelle est refusée, mémoriser le choix de l'utilisateur et ne pas afficher vous connecter manuellement à nouveau, mais continuez à essayer la connexion automatique au démarrage.

De plus, vous devez vous assurer que les utilisateurs peuvent se connecter à votre jeu avec son compte des services de jeux Play avec un bouton dédié et facile à trouver.

Connexion automatique

La connexion automatique permet aux utilisateurs de se connecter à votre jeu sans difficulté. automatique ! Si votre jeu demande à l'utilisateur de se connecter et de se connecter automatiquement est activé (dans l'application Google Play Jeux), vous recevrez les services de jeux Play de l'utilisateur ses identifiants, et l'utilisateur accède à l'interface de connexion de PGS.

Les utilisateurs peuvent configurer le paramètre de connexion automatique selon leurs préférences. Ils peuvent choisir de se connecter automatiquement à tous les jeux ou d'être invités à se connecter à chaque fois.

Connexion automatique

Connexion manuelle

Si un utilisateur ne se connecte pas automatiquement au jeu, vous pouvez lui demander de se connecter manuellement. Les utilisateurs peuvent se connecter en un clic à partir d'une boîte de dialogue affichée en haut de votre jeu.

Connexion manuelle

Autoriser les pop-ups des services de jeux Play pour une expérience de connexion correcte

Lorsqu'ils utilisent les services de jeux Play, les utilisateurs doivent savoir qu'ils sont connectés. Cela se fait en montrant l'expérience de connexion aux services de jeux Play.

Pour présenter l'expérience de connexion, appelez la méthode setViewForPopups() de la classe GamesClient lors du démarrage du jeu. Ceci est essentiel pour pour offrir une expérience utilisateur correcte.

Niveaux d'accès OAuth et services de jeux Play

PGS s'appuie sur le système OAuth pour permettre aux utilisateurs de d'autoriser votre jeu à accéder à son compte. Les champs d'application OAuth sont des autorisations que vous, développeur peut demander. Si elles sont accordées, ces autorisations permettent à votre jeu d'appeler certains API pour le compte de l'utilisateur et vous donnent également accès à certaines parties compte Google.

Les services de jeux Play ont 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.

Votre jeu peut demander tous les niveaux d'accès dont vous avez besoin pour créer une expérience de jeu exceptionnelle pour vos utilisateurs. Votre jeu peut demander tous les niveaux dont il a besoin dans un seul bundle, limitant le nombre de demandes d'accès au compte Google. Toutefois, présente un inconvénient majeur. Si vous demandez plus de champs d'application que ceux spécifiques aux services de jeux Play, la connexion automatique ne peut pas aboutir. La connexion automatique est le meilleur moyen joueurs connectés à votre jeu.

Il est recommandé d'utiliser des demandes de champ d'application incrémentielles. Votre jeu doit demander les champs d'application réservés aux services de jeux Play (PGC) en premier dans la requête initiale, puis les autres champs d'application sont demandés ; séparément à un moment plus pertinent.

L'accès OAuth est accordé à l'aide d'un écran différent pour chaque champ d'application. Cela permet aux utilisateurs de décider, de manière précise, les niveaux d'accès auxquels leur donner accès. En utilisant connexion automatique uniquement avec les habilitations PGS, les utilisateurs n'auront à interagir avec aucune Invites OAuth, ce qui réduit la friction de connexion.

Compatibilité avec plusieurs méthodes de connexion

PGS fournit une identité de jeu aux joueurs Android, mais elle n'a pas besoin d'être la seule identité connectée à vos utilisateurs. Vous pouvez connecter les joueurs via PGS, un de réseau social et votre propre système d'identification dans le jeu. Chaque apporte une valeur unique à vous et à vos joueurs. Tous peuvent fonctionner pour offrir une expérience optimale aux joueurs Android.

Récupérer et valider l'identité du joueur de manière sécurisée pour l'intégration backend

Vous pouvez demander un code d'autorisation pour permettre à votre serveur de communiquer directement avec les serveurs des services de jeux Play via l'API REST sous l'autorité du joueur connecté. Cela permet un accès direct à l'ID du joueur, à son profil et à d'autres informations (comme la liste d'amis, si l'accès à celle-ci est autorisé). Si vous stockez des ID de joueur, des ID d'ami ou d'autres données associées dans votre backend, cette méthode doit être utilisée pour éliminer le risque de manipulation de ces champs côté appareil.

En outre, pour certains jeux plus anciens et certains joueurs, l'ID de joueur renvoyé par le SDK Android peut être différent de celui que les autres joueurs voient pour le joueur en question dans le même jeu ; ceci est particulièrement pertinent pour la liste d'amis. En revanche, le player_id renvoyé dans l'API REST est toujours cohérent et correspond toujours à l'ID visible par les autres joueurs.

Pour en savoir plus, consultez Accès hors connexion et la documentation sur l'API REST.

Implémentation client

Pour découvrir comment implémenter la connexion sous Android, consultez Se connecter dans les jeux Android.