Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

S'authentifier dans Unity à l'aide des services de jeux Google Play

Vous pouvez utiliser les services de jeux Google Play pour connecter des joueurs à un jeu Android conçu sur Firebase et Unity. Pour utiliser la connexion aux services de jeux Google Play avec Firebase, connectez d'abord le joueur avec Google Play Jeux, puis demandez un code d'authentification OAuth 2.0. Ensuite, transmettez le code d'authentification à PlayGamesAuthProvider pour générer des identifiants Firebase, que vous pourrez utiliser pour vous authentifier auprès de Firebase.

Avant de commencer

Configurer votre projet Unity

Ajoutez le fichier de configuration Firebase et le Firebase Unity SDK à votre projet Unity comme décrit dans Ajouter Firebase à votre projet Unity. Suivez les instructions pour Android.

Veillez à importer FirebaseAuth.unitypackage.
Dans l'éditeur Unity, sous Build Settings > Player Settings > Other Settings (Paramètres de compilation > Paramètres du lecteur > Autres paramètres), définissez le nom de package Android de votre jeu.
Ensuite, sous Build Settings > Player Settings > Publishing Settings (Paramètres de compilation > Paramètres du lecteur > Paramètres de publication), sélectionnez ou créez un keystore et une clé, qui seront utilisés pour signer votre package Android. Votre APK doit être signé pour que la connexion à Play Jeux fonctionne. Cette exigence s'applique non seulement à la publication, mais également au développement de votre jeu.

Configurer votre projet Firebase

Dans la Firebase console, accédez au projet Firebase dans lequel vous avez enregistré votre projet Unity.
Spécifiez l'empreinte SHA-1 de votre jeu.
1. Dans la console Firebase, accédez aux Settings > General (Paramètres > Général).
2. Faites défiler la page jusqu'à la fiche Your apps (Vos applications), sélectionnez votre application Android, puis ajoutez votre empreinte SHA-1 dans le champ SHA certificate fingerprints (Empreintes de certificat SHA).
Vous pouvez obtenir l'empreinte SHA-1 de votre clé à l'aide de la commande keytool :
```
keytool -exportcert -list -v \
    -alias YOUR-KEY-NAME -keystore PATH-TO-KEYSTORE
```
Vous pouvez également obtenir le hachage SHA de votre certificat de signature à l'aide de la commande gradle signingReport :
```
gradlew signingReport
```
Pour savoir comment obtenir l'empreinte SHA de votre application, consultez Authentifier votre client.

Votre APK doit être signé avec cette clé, y compris pendant le développement.
Activez Google Play Games en tant que fournisseur de connexion :
1. Dans la console Firebase, accédez à Security > Authentication.
2. Générez et obtenez l'ID client et le code secret du client de votre serveur Web :
  1. Dans l'onglet Sign-in method (Méthode de connexion), activez le fournisseur de connexion Google.
  2. Copiez l'ID client et le code secret du client du serveur Web à partir du fournisseur de connexion Google.
3. Dans l'onglet Sign-in method (Méthode de connexion), activez le fournisseur de connexion Play Games sign-in provider (Play Jeux), puis spécifiez l'ID client et le code secret du client de votre serveur Web, que vous avez obtenus à l'étape précédente.

Configurer Play Games services avec les informations de votre application Firebase

Dans la Google Play Console, ouvrez votre Google Play application ou créez-en une.
Dans la section Grow (Développement), cliquez sur Play Games services > Configuration et gestion > Configuration.
Cliquez sur Yes, my game already uses Google APIs (Oui, mon jeu utilise déjà des API Google), sélectionnez votre projet Firebase dans la liste, puis cliquez sur Use (Utiliser).
Sur la page de configuration Play Games services, cliquez sur Add Credential (Ajouter des identifiants).
1. Sélectionnez le type Game server (Serveur de jeu).
2. Dans le champ OAuth client (Client OAuth), sélectionnez l'ID client Web de votre projet. Assurez-vous qu'il s'agit du même ID client que celui que vous avez spécifié lorsque vous avez activé Play Games la connexion.
3. Enregistrez les modifications.
Toujours sur la page de configuration Play Games services, cliquez Add Credential à nouveau.
1. Sélectionnez le type Android.
2. Dans le champ OAuth client (Client OAuth), sélectionnez l'ID client Android de votre projet. (Si vous ne voyez pas votre ID client Android, assurez-vous d'avoir défini l'empreinte SHA-1 de votre jeu dans la console Firebase.)
3. Enregistrez les modifications.
Sur les pages Events (Événements), Achievements (Succès) et Leaderboards (Classements), créez les Play Games ressources que vous souhaitez utiliser avec votre jeu (si vous ne souhaitez pas en utiliser immédiatement, vous pouvez créer une entrée d'espace réservé). Ensuite, sur l'une des pages Events (Événements), Achievements (Succès) ou Leaderboards (Classements), cliquez sur Get resources (Obtenir des ressources) et copiez l'extrait de code des ressources Android dans un emplacement pratique. Vous aurez besoin de cet extrait de code pour configurer le Google Play Games services plug-in.

Voici à quoi ressemble l'extrait de code des ressources :
```
<?xml version="1.0" encoding="utf-8"?>

<resources>
  
  <string name="app_id" translatable="false">123456789000</string>
  
  <string name="package_name" translatable="false">com.example.game</string>
  
  <string name="event_wiped_raid" translatable="false">CgkIpKjv1a4PEAIYBA</string>
</resources>
```
Sur la page Testers (Testeurs), ajoutez les adresses e-mail des utilisateurs qui doivent pouvoir se connecter à votre jeu avant sa publication sur le Play Store.

Intégrer la connexion à Play Jeux dans votre jeu

Téléchargez la dernière version du plug-in Play Jeux pour Unity et extrayez-la.
Importez le package Unity du plug-in dans votre projet Unity. Vous trouverez le package Unity dans le répertoire current-build de l'archive de la version.
Configurez le plug-in Play Jeux :
1. Cliquez sur Window > Google Play Games > Setup > Android Setup (Fenêtre > Google Play Jeux > Configuration > Configuration Android) pour ouvrir l'écran Android Configuration (Configuration Android).
2. Collez l'extrait de code des ressources Android que vous avez obtenu dans la Play Console dans le champ Resources Definition (Définition des ressources).
3. Collez l'ID client de votre serveur Web, que vous avez fourni lorsque vous avez activé la connexion à Play Jeux dans la Firebase console, dans le champ Client ID.
4. Cliquez sur Setup (Configurer).

Dans votre jeu, configurez un client Play Games avec le paramètre RequestServerAuthCode activé :

using GooglePlayGames;
using GooglePlayGames.BasicApi;
using UnityEngine.SocialPlatforms;
using System.Threading.Tasks;

PlayGamesClientConfiguration config = new PlayGamesClientConfiguration.Builder()
    .RequestServerAuthCode(false /* Don't force refresh */)
    .Build();

PlayGamesPlatform.InitializeInstance(config);
PlayGamesPlatform.Activate();

Ensuite, lorsqu'un joueur choisit de se connecter avec Play Jeux, appelez Social.localUser.Authenticate() :
```
Social.localUser.Authenticate((bool success) => {
  // handle success or failure
});
```

S'authentifier auprès de Firebase

Une fois que vous avez ajouté la connexion à Play Games à votre jeu, vous pouvez utiliser le code d'authentification des services Play Games pour vous authentifier auprès de Firebase.

Une fois que le joueur s'est connecté à l'aide de Play Jeux, dans le gestionnaire de continuation de la connexion, obtenez un code d'authentification pour le compte du joueur :
```
Social.localUser.Authenticate((bool success) => {
  if (success) {
    authCode = PlayGamesPlatform.Instance.GetServerAuthCode();
  }
});
```

Ensuite, échangez le code d'authentification des services de jeux Play contre des identifiants Firebase, puis utilisez ces identifiants pour authentifier le joueur :

Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
Firebase.Auth.Credential credential =
    Firebase.Auth.PlayGamesAuthProvider.GetCredential(authCode);
auth.SignInAndRetrieveDataWithCredentialAsync(credential).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("SignInAndRetrieveDataWithCredentialAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("SignInAndRetrieveDataWithCredentialAsync encountered an error: " + task.Exception);
    return;
  }

  Firebase.Auth.AuthResult result = task.Result;
  Debug.LogFormat("User signed in successfully: {0} ({1})",
      result.User.DisplayName, result.User.UserId);
});

Étapes suivantes

Lorsqu'un nouvel utilisateur se connecte pour la première fois, un compte utilisateur est créé et associé à son ID Play Jeux. Ce nouveau compte est stocké dans votre projet Firebase et peut être utilisé pour identifier un utilisateur dans toutes les applications de votre projet.

Dans votre jeu, vous pouvez obtenir l'UID Firebase de l'utilisateur à partir de l'objet Firebase.Auth.FirebaseUser :

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null && user.IsValid()) {
  string playerName = user.DisplayName;

  // The user's Id, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server, if you
  // have one; use User.TokenAsync() instead.
  string uid = user.UserId;
}

Dans les règles de sécurité de votre Firebase Realtime Database et de Cloud Storage, vous pouvez obtenir l'ID utilisateur unique de l'utilisateur connecté à partir de la variable auth, et l'utiliser pour contrôler les données auxquelles un utilisateur peut accéder.

Pour obtenir les informations du joueur Play Jeux ou accéder aux services de jeux Play, utilisez les API fournies par le plug-in Play Jeux.

Pour déconnecter un utilisateur, appelez SignOut() :

auth.SignOut();