L'API Recall permet aux jeux d'utiliser les services de jeux Play (PGS) à vos mécanismes de connexion existants (Google Sign-In, par exemple) et synchronisez joueurs d'informations de connexion sur leurs appareils afin de réduire la perte d'utilisateurs. et améliorer la fidélisation au 1er jour. L'API gère les associations entre le compte de services de jeux Play (PGS) d'un utilisateur et leurs comptes de jeu en stockant des jetons de rappel sur les serveurs Google. Voici un Exemple de scénario d'utilisation de l'API Recall:
Un utilisateur joue à un jeu dans lequel le développeur a mis en place un système d'identité permettant au joueur de suivre sa progression. Ce développeur utilise PGS en parallèle avec d'autres méthodes d'authentification pour connecter les utilisateurs à son jeu. Dans cet exemple, une utilisatrice est connectée à son compte PGS (Laura) et crée un compte dans le jeu (Racer94) avec le système d'identité du développeur. Lorsque l'utilisatrice joue au jeu, le serveur de jeu du développeur synchronise sa progression.
Par ailleurs, le développeur enregistre un jeton de rappel auprès de Google, qui correspond au compte de jeu de l'utilisatrice. Google stocke automatiquement ce jeton de rappel dans le profil PGS de l'utilisatrice.
L'utilisateur décide à présent de jouer au jeu sur Google Play Jeux sur sur ordinateur pour la première fois en temps réel. L'utilisateur est automatiquement connecté avec son compte PGS. Le client du jeu vérifie si une progression est disponible pour ce service de jeux Play. utilisateur. Le serveur de jeu interroge ensuite Google pour savoir s'il existe des jetons pour ce compte PGS. Comme c'est le cas, Google renvoie le jeton de rappel, le serveur de jeu utilise ce jeton pour trouver le compte associé à l'utilisateur Racer94 et restaurer leur progression. La connexion via PGS est expérience fluide, la progression de l'utilisateur est restaurée par l'application l'utilisateur ayant besoin de saisir un nom d'utilisateur ou un mot de passe. De plus, le développeur peuvent se connecter à PGS avec leur système d'identité existant et s'appuyer sur pour stocker le lien entre la progression du joueur et son compte PGS.
Comme le montre l'exemple ci-dessus, deux actions principales sont effectuées par l'API Recall:
- Stockage du jeton auprès de Google lorsqu'un utilisateur se connecte avec l'un des appareils du jeu Google Cloud.
- récupérer le jeton d'un utilisateur afin de restaurer son compte dans le jeu ; Google Cloud.
En plus des jetons de rappel, l'API Recall nécessite un identifiant stable correspondant au compte de jeu, appelé persona, pour appliquer contraintes de cardinalité. Vous pourriez penser à un personnage comme libellé, qui représente le compte de jeu de l'utilisateur dans le système d'identité, et le jeton de rappel en tant que clé servant à restaurer le compte de jeu de l'utilisateur au jeu. Les valeurs des personas et des jetons ne doivent pas être réutilisées à travers différents Projets PGS. De plus, bien que les jetons de rappel puissent être modifiés au fil du temps, un persona doit être stable en fonction du compte de jeu de l'utilisateur.
Règles de cardinalité
L'API Recall applique une relation individuelle entre les profils PGS et les comptes de jeu (appelés règles de cardinalité), c'est-à-dire qu'un persona ne peut être lié qu'à un seul profil PGS et vice-versa. Le persona sert d'identifiant stable pour un compte de jeu, car les jetons de rappel peuvent changer au fil du temps.
Le persona associé à un profil PGS peut également être modifié au fil du temps (car différents comptes de jeu sont liés au profil PGS).
Flux techniques détaillés pour le stockage et la récupération des jetons de rappel
Cette section traite du flux technique entre le client de jeu, le serveur de jeu, et les serveurs de Google lors du stockage et de la récupération des jetons de rappel:
Étape 1 : Connecter l'utilisateur PGS et récupérer l'ID de session
Le jeu initialise le SDK de PGS et tente de connecter l'utilisateur à PGS.
En supposant que l'utilisateur est connecté, demandez un ID de session au SDK Jeux sur le client de jeu, puis demandez un jeton OAuth 2.0 au backend OAuth de Google. L'ID de session et les jetons OAuth 2.0 permettent de communiquer avec le backend de Jeux Google.
Étape 2 : Récupérer tout jeton de rappel disponible
Demandez tout jeton de rappel associé au compte PGS de l'utilisateur. Si un jeton est présent, passez à l'étape 3a et restaurez la progression. Sinon, s'il s'agit d'un nouvel utilisateur et qu'aucun jeton n'est présent, passez à l'étape 3b et stockez un nouveau jeton.
Étape 3a : Si un jeton est présent, restaurer la progression
Si un jeton est présent, récupérez-le et déchiffrez-le, puis restaurez les données de l'utilisateur.
Étape 3b : En l'absence de jeton, en stocker un
Comme aucun jeton n'est présent, aucune progression n'est restaurée. L'utilisateur se connecte au système d'identité du développeur ou crée un compte s'il n'en possède pas.
Créez un jeton de rappel chiffré qui encode le compte de jeu de l'utilisateur, puis envoyez-le à Google avec l'ID de session et le jeton OAuth 2.0. À ce stade, Google crée une association entre le jeton de rappel envoyé et le compte PGS du joueur.
Flux pour les utilisateurs sans profil de services Play Jeux
Vous pouvez stocker des jetons de rappel pour un utilisateur qui n'a pas encore créé de profil PGS en procédant comme suit : en utilisant le mode sans profil. Toutefois, deux mises en garde importantes sont à prendre en compte:
- Vous ne pouvez pas récupérer les jetons d'un utilisateur qui ne possède pas de profil PGS. Profil création s'affiche automatiquement lorsque l'utilisateur tente de se connecter à votre jeu avec les services de jeux Play sur un deuxième appareil.
- Vous devez suivre des consignes supplémentaires
pour vous assurer que vous disposez d'une notification appropriée décrivant les éléments suivants et
l'obtention du consentement adéquat de l'utilisateur final:
- Votre partage des données avec Google pour activer le compte Play Jeux la fonctionnalité d'association.
- La disponibilité des paramètres permettant de gérer ce partage, comme Play Jeux paramètres.
- Le traitement de ces données conformément aux Règles de confidentialité de Google Règlement.
Stocker un jeton et une paire de personas
- Un utilisateur sans profil de services Play Jeux ouvre un jeu faisant l'objet d'un rappel sans profil est activé.
- Le SDK Jeux déclenche une connexion automatique, qui échoue, car l'utilisateur a aucun profil PGS.
- Le SDK Games affiche un snackbar qui informe l'utilisateur que le jeu dispose l'intégration à Google. Ce snackbar est exploitable. L'utilisateur peut désactiver le rappel jusqu'à la création d'un profil.
- Le jeu demande l'accès au rappel. Notez que PGS n'accepte pas les demandes d'accès liées à un rappel. lorsqu'il existe des profils PGS sur l'appareil ou qu'aucun service Google Comptes sur l'appareil. Dans ce cas, le jeu doit continuer sans utiliser Services de jeux Play.
- Une fois que l'utilisateur s'est connecté avec un compte de jeu, le jeu crée un jeton pour l'utilisateur correspondant à son compte de jeu. Le match enregistre cette paire avec Google. Par la suite, le jeu peut stocker davantage de jetons se connecte à d'autres comptes de jeu.
Lancer un jeu sur un nouvel appareil
- Un utilisateur sans profil de services Play Jeux ouvre un jeu pour lequel le rappel sans profil est activé sur un appareil.
- Le jeu enregistre un jeton de rappel sans profil, comme décrit dans l'article Stocker un jeton. et la paire de personas.
- L'utilisateur ouvre le même jeu sur un autre appareil associé au même compte. configuration.
- Le SDK Jeux déclenche la création du profil. L'utilisateur peut consulter et refuser les jetons de rappel précédemment stockés. L'utilisateur crée alors un profil PGS.
- La connexion automatique au service PGS est terminée, et le jeu reçoit la l'état authentifié.
- Le jeu récupère les jetons de rappel pour l'utilisateur comme d'habitude.
Étapes suivantes
Pour intégrer l'API Recall à votre client et à votre serveur de jeu, procédez comme suit : ce guide d'implémentation.