Connectez facilement les utilisateurs à votre jeu tout en continuant à utiliser votre propre système de compte. Les API Recall des services de jeux Play vous permettent d'associer des comptes de jeu à un compte des services de jeux Google Play. Ainsi, lorsqu'un utilisateur joue à votre jeu sur différents appareils (ou sur le même appareil après l'avoir réinstallé), vous pouvez interroger le compte de jeu associé et simplifier le processus de connexion.
Si vous avez intégré les API Android Recall, ces API Recall devraient vous être familières. Toutes les intégrations côté serveur avec le rappel des services de jeux Play peuvent être réutilisées par les titres PC, car elles sont identiques sur Android et sur PC.
Prérequis
Terminez la configuration du SDK.
Consultez la présentation de l'API Recall des services de jeux Play.
Configurez les services de jeux Play dans la Play Console.
Étape 1 : Ajoutez l'ID de votre projet Play Jeux dans le fichier manifeste
Une fois la configuration des services de jeux Play terminée dans la Play Console, votre jeu dispose désormais d'un ID de projet associé aux services de jeux Play. À l'aide de cet ID de projet, que vous trouverez sur la page de configuration des services de jeux Play dans la Play Console, mettez à jour le manifest.xml de votre jeu.
Exemples de contenus manifest.xml :
<?xml version="1.0" encoding="utf-8"?>
<Manifest version="1">
<Application>
<PackageName>com.example.package</PackageName>
<PlayGamesServices>
<ProjectId>123456789</ProjectId>
</PlayGamesServices>
</Application>
</Manifest>
Étape 2 : Demandez l'accès à la fonctionnalité Rappel lorsque vous vous connectez
Lorsque votre jeu gère un flux de connexion, par exemple en ajoutant un compte dans le jeu, demandez l'accès à Récupération à l'aide de GamesRecallClient::RequestRecallAccess().
Cet appel renvoie un ID de session utilisé par votre backend pour effectuer des appels côté serveur à Google afin d'associer et de dissocier vos comptes de jeu à un utilisateur des services de jeux Play.
auto promise = std::make_shared<std::promise<RecallAccessResult>>();
games_recall_client.RequestRecallAccess(params, [promise](RecallAccessResult result) {
promise->set_value(std::move(result));
});
auto recall_access_result = promise->get_future().get();
if (recall_access_result.ok()) {
auto recall_session_id = recall_access_result.value().recall_session_id;
// Pass the recall session ID to your backend game server so it can query
// for an existing linked in-game account.
// - If you discover an existing linked in-game account, continue to sign-in
// the in-game account. This provides a seamless cross-device sign-in
// experience.
// - If there is not an existing linked in-game account, when the user
// completes the sign-in using your in-game account system record the
// account linking with Play Games Services Recall. This helps to provide
// a seamless cross-device sign-in experience when the user returns on a
// different device or after re-installing your game on the same device.
} else {
// Handle the error
}
Étape 3 : Traitez l'ID de session de rappel
Une fois que votre jeu a récupéré l'ID de session Recall et l'a transmis à votre serveur de jeu backend, utilisez les API REST côté serveur des services de jeux Play pour :
- Interroger les comptes de jeu associés existants à l'aide de
recall.retrieveTokens - Ajouter ou modifier des comptes de jeu associés à l'aide de
recall.linkPersona - Supprimer les comptes de jeu associés à l'aide de
recall.unlinkPersona
Pour obtenir un guide plus détaillé sur l'intégration côté serveur, consultez la documentation sur l'utilisation de l'API Recall dans votre serveur de jeu.