Authentification sur la plate-forme pour les jeux Android

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().
  }
});

Empêcher la création automatique de profils

Vous pouvez désactiver les invites de création automatique de profils via le fichier manifeste. Ainsi, les utilisateurs ne disposant pas d'un profil services Play Games peuvent continuer à charger le jeu sans être invités à en créer un. Pour en savoir plus, consultez Options de création de profils.

Pour utiliser cette fonctionnalité, assurez-vous que les conditions suivantes sont remplies :

• Aucun profil Services de jeux Play n'existe sur les comptes Google connectés à l'appareil.
• Votre jeu est intégré au SDK des services Play Jeux com.google.android.gms:play-services-games-v2:21.0.0 ou version ultérieure.

Pour empêcher les invites de création automatique de profils, procédez comme suit :

1. Dans le fichier AndroidManifest.xml, ajoutez la com.google.android.gms.games.SUPPRESS_GAME_PROFILE_CREATION balise dans l' <meta-data> élément et les attributs à l'<application> élément :

   <application>
       ...
       <meta-data
           android:name="com.google.android.gms.games.SUPPRESS_GAME_PROFILE_CREATION"
           android:value="true" />
       ...
   </application>
   

   Si cet indicateur est défini sur "true", les services Play Games sont informés que votre jeu gérera le processus de création de profils. Par conséquent, les services Play Jeux n'affichent pas automatiquement l'interface utilisateur de création de profils pour les utilisateurs de l'appareil qui ne disposent pas d'un profil Services Play Jeux.

2. Lorsque vous appelez une API des services Play Jeux, le GamesClientStatusCodes.SIGN_IN_REQUIRED code d'état indique que l'appel a échoué, car l'utilisateur n'a pas pu être authentifié automatiquement en raison de l'absence d'un profil Services Play Jeux.

   Ainsi, les utilisateurs ne disposant pas d'un profil services Play Games peuvent utiliser les méthodes d'authentification que vous avez implémentées sans être immédiatement invités à créer un profil services Play Games. La création de profils peut être lancée en appelant GamesSignInService.signin().

   import com.google.android.gms.games.PlayGames;
   ...
   
   // Get the achievements client using Play Games services.
   AchievementsClient achievementsClient = PlayGames.getAchievementsClient(getActivity());
   achievementsClient.getAchievementsIntent()
       .addOnFailureListener(
           new OnFailureListener() {
             @Override
             public void onFailure(@NonNull Exception exception) {
               int statusCode = ((ApiException) exception).getStatusCode();
               if (statusCode == GamesClientStatusCodes.SIGN_IN_REQUIRED) {
                 // SIGN_IN_REQUIRED: The user needs to sign in with Play Games Services.
                 // Call GamesSignInService.signin() to prompt for
                 // authentication at a suitable time which will trigger the
                 // profile creation UI.
                 // (e.g., after a tutorial). Use GamesSignInService.isAuthenticated() to check auth status.
               }
             }
           });

3. Après avoir ajouté la balise de suppression, utilisez la fenêtre logcat pour vérifier l'ajout. La sortie logcat contient un message semblable à celui-ci : "Game opted out of automatic profile creation prompt (using manifest)" (Le jeu a désactivé l'invite de création automatique de profils [à l'aide du fichier manifeste]).