Pour intégrer votre jeu aux services de jeux Google Play, commencez par implémenter l'authentification de la plate-forme. Cette autorisation est requise pour accéder à toutes les autres fonctionnalités, telles que 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.
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 ne disposent pas d'un profil Services de jeux Play lorsqu'ils lancent 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 automatiquement lorsque vous lancez un jeu sans profil Play Jeux.
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 :
- Lors de la séquence de démarrage de votre jeu, implémentez la création de profil à déclenchement automatique.
- Si l'authentification automatique échoue ou si vous la refusez, affichez un bouton de connexion manuelle pour que vous puissiez vous authentifier 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, la fonctionnalité de création de profil se déclenche, et tente d'authentifier l'utilisateur ou de créer un compte.
Si l'authentification automatique échoue ou si vous la refusez, affichez un bouton de connexion manuelle pour que vous puissiez vous authentifier ultérieurement.
Pour en savoir plus sur l'intégration de l'authentification à votre projet de jeu, consultez la documentation 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.