Pour intégrer votre jeu aux services de jeux Google Play, commencez par implémenter l'authentification de la plate-forme. Cette étape est nécessaire pour accéder à toutes les autres fonctionnalités, comme les succès, les classements et les événements.
Pour respecter les Consignes relatives à l'expérience utilisateur de Google Play Jeux Level Up, votre jeu doit être conforme au flux d'authentification recommandé.
Initialisation et authentification
Cette étape est obligatoire 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 la page Authentification de plate-forme pour les jeux Android. Cette étape est obligatoire pour accéder aux fonctionnalités des services de jeux Play, comme 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 verront un message de bienvenue une fois l'authentification réussie.
Options de création de profil
Un profil Services de jeux Play est nécessaire pour que les joueurs puissent interagir avec la plate-forme. Il est possible que certains joueurs n'aient pas de profil Play Jeux lorsqu'ils commencent votre jeu. Ces joueurs seront invités à en créer un.
Vous pouvez choisir l'expérience qui convient le mieux à 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 s'affichent automatiquement par défaut lorsque vous lancez un jeu sans profil dans les services de jeux Play.
Invite à créer un profil lorsque vous lancez un jeu (cliquez pour agrandir). Désactiver les invites de création de profil au lancement et ajouter des invites manuelles après l'initialisation du jeu Vous pouvez désactiver les invites de création de profil déclenchées automatiquement via le fichier manifeste. Cela permet aux utilisateurs sans profil de services de jeux Play de poursuivre les méthodes d'authentification que vous avez implémentées sans être immédiatement 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é, nous vous recommandons de lancer une invite de création de profil Obtenir le résultat de l'authentification pour encourager l'inscription à la plate-forme Play Jeux. Déclenchez cette invite à votre discrétion, mais assurez-vous qu'elle s'affiche 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 aux 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.
Flux d'authentification recommandé
Pour respecter les consignes relatives à l'expérience utilisateur du programme Level Up de Google Play Jeux, vérifiez que vous respectez les exigences de continuité du joueur. Pour connecter les joueurs à votre jeu, utilisez le flux d'authentification suivant :
- Pendant la séquence de démarrage de votre jeu, examinez les options de création de profil et sélectionnez-en une.
- Si la connexion automatique ne fonctionne pas ou si l'utilisateur la refuse, prévoyez un bouton de connexion manuelle au cas où l'utilisateur souhaiterait se connecter ultérieurement.
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.
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.
Plusieurs services d'authentification
Les services de jeux Play fournissent une identité de jeu aux joueurs Android, mais celle-ci ne doit pas nécessairement être la seule identité connectée à vos utilisateurs. Vous pouvez simultanément authentifier les joueurs à l'aide des services de jeux Play, d'un identifiant de réseau social et de votre propre système d'ID de jeu.
API Recall
L'API Recall permet aux jeux de gérer les liens entre les utilisateurs PGS et leurs comptes de jeu en stockant des jetons de rappel auprès des serveurs Google. Pour savoir comment activer cette fonctionnalité, consultez Intégrer l'API Recall des services de jeux Play à votre jeu.
Intégration du client de jeu
Lorsque vous intégrez l'authentification à votre projet de jeu, nous recommandons le parcours utilisateur suivant :
Lors de la séquence de démarrage de votre jeu, les options de création de profil se déclenchent et tentent de connecter l'utilisateur ou de créer un compte.
Si l'authentification automatique ne fonctionne pas ou si l'utilisateur la refuse, prévoyez un bouton de connexion manuelle au cas où l'utilisateur souhaiterait se connecter ultérieurement.
Pour en savoir plus sur l'intégration de l'authentification à votre projet de jeu, consultez le guide de démarrage correspondant à votre type de projet :
Intégration du serveur de jeu
Vous pouvez obtenir un code d'autorisation du serveur en appelant requestServerSideAccess une fois que vous avez vérifié que le joueur est authentifié. Transmettez ce code d'autorisation de serveur à votre serveur de jeu backend pour communiquer directement avec les serveurs des services de jeux Play. Cette communication permet à votre serveur d'accéder aux données des joueurs, y compris :
- ID de joueur
- Profil
- Liste d'amis
- Progression dans le jeu
- Exploits
Votre serveur utilise ensuite ce code d'autorisation avec l'API REST pour interagir de manière sécurisée avec les serveurs des services de jeux Play. Pour en savoir plus, consultez Accès côté serveur aux services de jeux Play.
Quota de requêtes de connexion
Les requêtes de connexion aux services de jeux Play sont soumises à un quota quotidien. Pour en savoir plus, consultez Gérer votre quota quotidien.