Authentification de la plate-forme pour les jeux Android

Pour pouvoir accéder aux fonctionnalités des services de jeux Google Play, votre jeu doit fournir le compte du joueur authentifié. Cette documentation explique comment mettre en œuvre une expérience d'authentification fluide dans votre jeu.

Le SDK des services de jeux Play v2 propose diverses améliorations qui augmentent le nombre d'utilisateurs authentifiés dans votre jeu et facilitent le développement :

  • Améliorations pour les utilisateurs :
    • Après avoir sélectionné un compte par défaut, les utilisateurs sont authentifiés sans avoir à interagir avec une invite.
    • Les utilisateurs n'ont plus besoin de télécharger l'application Play Jeux pour s'authentifier auprès des services de jeux Play ni pour créer un compte.
    • Les utilisateurs peuvent désormais gérer le compte de leurs services de jeux Play pour plusieurs jeux à partir d'une seule page.
  • Améliorations pour les développeurs :
  • Le code client n'a plus besoin de gérer le flux d'authentification ou de déconnexion, car la connexion est automatiquement déclenchée au démarrage du jeu, tandis que la gestion du compte a lieu dans les paramètres de l'OS.

Intégration d'un nouveau client

Cette section explique comment intégrer un nouveau client avec les services de jeux Play Sign-In v2.

Ajouter la dépendance

Ajoutez la dépendance du SDK des services de jeux Play au fichier build.gradle racine de votre application. Si vous utilisez Gradle, vous pouvez ajouter ou mettre à jour la dépendance comme suit :

dependencies {
 implementation "com.google.android.gms:play-services-games-v2:+"
}

Définir l'ID du projet

Pour ajouter l'ID de projet du SDK des services de jeux Play à votre application, procédez comme suit :

  1. Dans le fichier AndroidManifest.xml de votre application, ajoutez l'élément <meta-data> et les attributs suivants à l'élément <application> :

    <manifest>
  <application>
    <meta-data android:name="com.google.android.gms.games.APP_ID"
               android:value="@string/game_services_project_id"/>
  </application>
</manifest>

    Définissez la référence de la ressource de chaîne @string/game_services_project_id en indiquant l'ID de projet des services de jeux correspondant à votre jeu. L'ID de projet des services de jeux se trouve sous le nom de votre jeu sur la page Configuration de la Google Play Console.

  2. Dans le fichier res/values/strings.xml, ajoutez une référence de ressource de chaîne et définissez l'ID du projet comme valeur. Dans Google Play Console, vous trouverez l'ID de votre projet sous le nom de votre jeu sur la page Configuration. Exemple :

    <!-- res/values/strings.xml -->
<resources>
  <!-- Replace 0000000000 with your game’s project id. Example value shown above.  -->
  <string translatable="false"  name="game_services_project_id"> 0000000000 </string>
</resources>

Initialiser le SDK

Initialisez le SDK Play Jeux dans le rappel onCreate(..) de la classe Application.

import com.google.android.gms.games.PlayGamesSdk;

...

@Override
public void onCreate(){
  super.onCreate();
  PlayGamesSdk.initialize(this);
}

Obtenir le résultat de l'authentification

Lorsque votre jeu se lance, il tente toujours d'authentifier l'utilisateur. Pour authentifier l'utilisateur, vous devez vérifier qu'il s'est bien authentifié, puis obtenir son ID de joueur.

Pour vérifier la tentative d'authentification, appelez GamesSignInClient.isAuthenticated() et utilisez addOnCompleteListener pour récupérer les résultats. Exemple :

GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(getActivity());

gamesSignInClient.isAuthenticated().addOnCompleteListener(isAuthenticatedTask -> {
  boolean isAuthenticated =
    (isAuthenticatedTask.isSuccessful() &&
     isAuthenticatedTask.getResult().isAuthenticated());

  if (isAuthenticated) {
    // Continue with Play Games Services
  } else {
    // Show a sign-in button to ask players to authenticate. Clicking it should
    // call GamesSignInClient.signIn().
  }
});

Si l'utilisateur choisit de ne pas s'authentifier au lancement du jeu, il est recommandé de continuer à afficher un bouton avec l'icône Play Jeux ou de présenter à l'utilisateur un écran de connexion avec un bouton comportant l'icône Play Jeux comme option d'authentification, et de réessayer d'authentifier l'utilisateur en appelant GamesSignInClient.signIn() s'il appuie sur le bouton. Après avoir vérifié que l'utilisateur est authentifié, vous pouvez récupérer l'ID du joueur pour l'identifier. Exemple :

PlayGames.getPlayersClient(activity).getCurrentPlayer().addOnCompleteListener(mTask -> {
    // Get PlayerID with mTask.getResult().getPlayerId()
  }
);