Rappel des services de jeux Play

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 Play. Ensuite, lorsqu'un utilisateur joue à votre jeu sur différents appareils (ou sur le même appareil après l'avoir réinstallé), vous interrogez le compte de jeu associé et simplifiez 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 service Recall des services de jeux Play peuvent être réutilisées par les titres PC, car elles sont identiques sur Android et sur PC.

Espace de noms : PlayPcSdkManaged.Recall

Classe de client : RecallClient

Prérequis

• Consultez la présentation de l'API Recall des services de jeux Play.

• Configurez les services de jeux Play dans la Play Console.

Ajouter l'ID de votre projet de services de jeux Play 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>

Remarque : Si vous souhaitez utiliser le SDK pour PC tout en développant dans l'éditeur Unity sans avoir à signer numériquement l'exécutable de votre jeu ni à le lancer depuis Google Play Jeux. Pour en savoir plus sur la configuration du fichier manifeste, consultez le guide de configuration du mode développeur.

Créer le client

Utilisez toujours la fabrique pour créer un RecallClient. Cela garantit que les rappels compatibles avec Unity sont automatiquement enregistrés.

using UnityEngine;
using System;
using System.Threading.Tasks;
// Required SDK Namespaces
using PlayPcSdkManaged.Recall;
using PlayPcSdkManaged.Unity;

public class RecallManager : MonoBehaviour
{
    private RecallClient _recallClient;

    public void SetupRecall()
    {
        try
        {
            // Creates the client with the required UnityRecallCallbacksHandler
            _recallClient = PlayPcSdkFactory.CreateRecallClient();
            Debug.Log("Recall Client created successfully.");
        }
        catch (Exception ex)
        {
            Debug.LogError($"Failed to create Recall Client: {ex.Message}");
        }
    }

    private void OnDestroy()
    {
        // Always dispose of the client to clean up native C++ resources
        _recallClient?.Dispose();
    }
}

Demander l'accès à Recall

Conseil : Nous vous recommandons d'utiliser l'API Recall pour interroger les comptes de jeu associés chaque fois que votre jeu est lancé. Pour les nouvelles installations, un compte de jeu associé peut être utilisé pour connecter facilement un utilisateur et restaurer sa progression. Pour les installations existantes, lorsque le compte de jeu associé change, cela indique que l'utilisateur a changé de compte sur un autre appareil. Vous pouvez lui faire gagner du temps en passant à ce compte.

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 RequestRecallAccessAsync.

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.

public async Task RequestRecallAccessAsync()
{
    try
    {
        Debug.Log("Requesting Recall access...");

        // Async call to retrieve the session ID
        var result = await _recallClient.RequestRecallAccessAsync();

        if (result.IsOk)
        {
            // On success, access the RecallSessionId
            var sessionId = result.Value.RecallSessionId;
            Debug.Log($"Recall Access Granted! Session ID: {sessionId}");

            // Pass 'sessionId' to your backend server to process account linking
        }
        else
        {
            // Handle expected API errors (e.g., Error)
            Debug.LogError($"Request Failed: {result.Code} - {result.ErrorMessage}");
        }
    }
    catch (Exception ex)
    {
        Debug.LogException(ex);
    }
}

Traiter l'ID de session de rappel

Une fois que votre jeu a récupéré l'ID de session de rappel 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.