Rappel des services de jeux Play

Connectez facilement les utilisateurs à votre jeu tout en continuant à utiliser votre propre système de comptes. Avec les API Recall des services de jeux Play, vous pouvez associer des comptes de jeu à un compte Google Play Jeux. Ensuite, lorsqu'un utilisateur joue à votre jeu sur différents appareils (ou sur le même appareil après avoir réinstallé votre jeu), vous interrogez le compte de jeu associé et simplifiez le processus de connexion.

Si vous avez intégré les API Recall Android, ces API Recall devraient vous être familières. Toutes les intégrations côté serveur avec Recall des services de jeux Play peuvent être réutilisées par les titres PC, car elles sont identiques sur Android et PC.

Espace de noms : PlayPcSdkManaged.Recall

Classe client : RecallClient

Prérequis

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

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

Ajouter l'ID de votre projet lié aux 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 est associé à un ID de projet lié 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 fichier manifest.xml de votre jeu.

Exemple de contenu 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 PC lors du développement dans l'éditeur Unity sans avoir à signer numériquement l'exécutable de votre jeu ni à le lancer depuis Google Play Jeux. Pour connaître les étapes de configuration supplémentaires 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 sécurisés pour 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 un utilisateur de manière transparente 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 processus de connexion, par exemple en ajoutant un compte de jeu, demandez l'accès à Recall à 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 Recall

Une fois que votre jeu dispose de 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 mettre à jour des comptes de jeu associés à l'aide de recall.linkPersona
• supprimer des 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 expliquant comment utiliser l'API Recall dans votre serveur de jeu.