Premiers pas avec les services de jeux Play pour Android

Attention : Ce guide concerne l'utilisation de la version 1 du SDK des services de jeux Play. Pour sur la dernière version du SDK, consultez la documentation de la version 2 du service de jeux Play.

Bienvenue dans le cours "Développement de jeux Android avec les services de jeux Google Play".

Le SDK Play Jeux fournit des services de jeux Google Play multiplates-formes qui vous permettent intégrer des fonctionnalités de jeu populaires telles que les réussites, les classements Jeux enregistrés sur votre tablette et vos jeux mobiles

Cette formation va vous guider dans l'installation d'un exemple d'application de jeu pour Android. et lancez-vous rapidement dans la création de votre propre jeu Android. La fonction Saisir un nombre L'application exemple de challenge montre comment intégrer les réussites et classements dans votre jeu.

Avant de commencer

Pour préparer votre application, procédez comme indiqué dans les sections suivantes.

Conditions requises pour l'application

Assurez-vous que le fichier de compilation de votre application utilise les valeurs suivantes :

• minSdkVersion égal à 19 ou plus
• compileSdkVersion égal à 28 ou plus

Configurer votre jeu dans la Google Play Console

La Google Play Console est l'endroit où vous gérez les services de jeux Google Play de votre jeu et où vous configurez les métadonnées pour l'autoriser et l'authentifier. Pour en savoir plus, consultez la page Configurer les services de jeux Google Play.

Configurer votre application

Dans le fichier build.gradle au niveau du projet, incluez Dépôt Maven de Google et le dépôt central Maven dans vos sections buildscript et allprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Ajoutez la dépendance des services Google Play pour le SDK Play Jeux à votre fichier de compilation Gradle du module, qui est généralement app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

Exemple de guide d'application

Cette formation vous explique comment installer un exemple d'application de jeu pour Android. et lancez-vous rapidement dans la création de votre propre jeu Android. La fonction Saisir-un-nombre L'application exemple de challenge montre comment intégrer les réussites et classements dans votre jeu.

Étape 1: Télécharger l'application exemple

Dans le cadre de ce guide du développeur, vous devez télécharger l'exemple de modèle Type-a-Number Challenge. Application Android.

Pour télécharger et configurer l'exemple d'application dans Android Studio:

1. Téléchargez les exemples Android à partir du page de téléchargement d'exemples.
2. Importez le projet android-basic-samples. Ce projet inclut TypeANumber et d'autres jeux Android exemples. Pour effectuer cette opération dans Android Studio:
   1. Cliquez sur Fichier > Importer un projet
   2. Accédez au répertoire dans lequel vous avez téléchargé android-basic-samples sur votre environnement de développement. machine. Sélectionnez le fichier android-basic-samples/build.gradle, puis cliquez sur OK.
3. Dans le module TypeANumber, ouvrez AndroidManifest.xml et remplacez le nom du package par com.google.example.games.tanc par un autre nom de package. Le nouveau nom du package doit ne doit pas commencer par com.google, com.example ni com.android.

Étape 2: Configurez le jeu dans la Google Play Console

La Google Play Console vous permet de gérer les services de jeux Google Play pour votre jeu. configurer les métadonnées pour l'autorisation et l'authentification de votre jeu.

Pour configurer l'exemple de jeu dans la Google Play Console:

1. Pointez votre navigateur Web sur la Google Play Console connectez-vous. Si vous ne vous êtes pas encore inscrit sur la Google Play Console, vous serez invité à le faire.
2. Suivez ces instructions pour Ajoutez votre jeu à la Google Play Console.
   1. Lorsqu'il vous est demandé si vous utilisez des API Google dans votre application, sélectionnez Je n'utilise pas encore d'API Google dans mon jeu.
   2. Pour les besoins de ce guide du développeur, vous pouvez remplir le formulaire avec les détails du jeu. Pour plus de commodité, vous pouvez utiliser les icônes d'espace réservé et les captures d'écran fournies sur la page Téléchargements.
3. Suivez ces instructions pour générer un ID client OAuth 2.0 pour votre application Android.
   1. Lorsque vous associez votre application Android, veillez à spécifier le package exact que vous avez utilisé précédemment pour renommer l'exemple de package.
   2. Vous pouvez utiliser l'assistant "Generate Signed APK Wizard" (Générer un APK signé) dans Android Studio pour : générez un nouveau keystore et un nouveau certificat signé si vous n'en avez pas déjà. Pour savoir comment exécutez l'Assistant "Generate Signed APK Wizard" (Générer un APK signé), consultez Signer votre application dans Android Studio
4. Veillez à enregistrer les informations suivantes pour plus tard:
   1. Votre ID d'application: il s'agit d'une chaîne composé uniquement de chiffres (généralement 12 ou plus) au début de votre ID client.
   2. Votre certificat de signature: notez le certificat que vous avez utilisé lors de la configuration. votre accès à l'API (le certificat dont vous avez fourni l'empreinte numérique SHA1). Toi devez utiliser le même certificat pour signer votre application lorsque vous testez ou publiez votre l'application.
5. Configurez les réussites pour Type-a-Number Challenge:
   1. Sélectionnez l'onglet Prouesses dans la Google Play Console.
   2. Ajoutez les exemples de réussite suivants:

      Nom	Description	Instructions spéciales
      Prime	Obtenez un score correspondant à un nombre premier.	Aucune
      Humble	Demander un score de 0	Aucune
      Ne soyez pas timide, mon enfant	Demandez un score de 9 999 dans les deux modes.	Aucune
      TRÈS TRÈS BIEN LEET !	Obtenir un score de 1 337.	Cette réussite doit être masquée.
      Vous vous ennuyez	Jouer 10 fois au jeu	Cette réussite doit être progressive, et est déverrouillée au bout de 10 étapes.
      Je m'ennuie vraiment	Jouer 100 fois au jeu	Cette réussite doit être progressive, et est déverrouillée au bout de 100 pas.

   3. Enregistrez les identifiants (longues chaînes alphanumériques) de chaque réussite que vous créé.
   4. Configurez les réussites adaptées à votre jeu. Pour en savoir plus, consultez la page présentant les concepts de la fonctionnalité de réussite et comment implémenter les réussites sous Android.
6. Configurez les classements pour Type-a-Number Challenge:
   1. Sélectionnez l'onglet Classements dans la Google Play Console.
   2. Ajoutez deux exemples de classement: l'un nommé "Meilleurs scores faciles" et l'autre. intitulés "Meilleurs scores". Les deux classements doivent utiliser le format de score "Entier" sans décimales, classés par ordre décroissant.
   3. Notez les identifiants (longues chaînes alphanumériques) de chaque classement que vous avez créé.
   4. Configurez des classements adaptés à votre jeu. Pour en savoir plus, consultez les concepts liés aux classements et comment implémenter les classements sous Android.
7. Ajoutez des comptes de test pour votre jeu. Cette étape n'est nécessaire que pour les applications qui n'ont pas encore été publiées dans la Google Play Console. Avant la publication de l'application, seuls les comptes de test répertoriés dans la Google Play Console peuvent se connecter. Cependant, dès qu'une application est publiée, tout le monde est autorisé à se connecter.

Avertissement :Si vous essayez d'effectuer des appels au SDK Play Jeux pour un jeu non publié en utilisant un compte qui n'est pas listé en tant que compte de test, les services de jeux Google Play se comportent comme si le jeu n'existait pas et que vous obtenez ConnectionResult.SIGN_IN_REQUIRED code renvoyé. Si vous tentez de lancer ConnectionResult.startResolutionForResult(), vous recevrez GamesActivityResultCodes.RESULT_SIGN_IN_FAILED

Étape 3: Modifiez votre code

Pour exécuter le jeu, vous devez configurer l'ID application en tant que ressource dans votre projet Android. Vous devez également ajouter des métadonnées de jeux dans AndroidManifest.xml.

1. Ouvrez res/values/ids.xml et remplacez les ID des espaces réservés. Si vous utilisez créer un jeu Android à partir de zéro, vous devez d'abord créer ce fichier.
   1. Indiquez l'ID de votre application dans la ressource app_id.
   2. Spécifiez chaque identifiant de réussite créé précédemment dans le champ correspondant achievement_*.
   3. Spécifiez chaque identifiant de classement que vous avez créé précédemment dans la leaderboard_*.
2. Ouvrez AndroidManifest.xml et saisissez le nom de votre package dans package. de la balise <manifest> . Si vous créez un jeu Android à partir de veillez à ajouter également le code suivant dans <application> :

   <meta-data android:name="com.google.android.gms.games.APP_ID"
       android:value="@string/app_id" />
   <meta-data android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version"/>
   

Étape 4: Testez votre jeu

Pour vous assurer que les services de jeux Google Play fonctionnent correctement dans votre jeu, testez le application avant de la publier sur Google Play.

Remarque :Nous vous recommandons d'effectuer le test sur un appareil Android physique. Toutefois, si vous n'avez pas d'appareil physique, vous pouvez le tester Android Emulator. Pour ce faire, téléchargez le fichier de l'émulateur, qui inclut services Google Play, sous Android 4.2.2, depuis le SDK Manager.

Pour exécuter votre jeu sur votre appareil de test physique:

1. Vérifiez que vous avez configuré le compte de test que vous utilisez pour vous connecter. à l'application (comme décrit à l'étape 2).
2. Exportez un APK et signez-le avec le même certificat que celui utilisé pour la configuration le projet dans la Google Play Console. Pour exporter un APK signé dans Android Studio, cliquez sur Créer > Générer un APK signé
3. Installez le fichier APK signé sur votre appareil de test physique à l'aide de l'outil adb. Pour savoir comment installer une application, voir Exécution sur un appareil.

Avertissement :Lorsque vous exécutez l'application directement à partir d'Android Studio, Android Studio signe l'application avec votre certificat de débogage par défaut. Si vous n'avez pas utilisé de débogage lors de la configuration de l'application dans la Google Play Console, provoque des erreurs. Veillez à exécuter un APK que vous avez exporté et signé avec un certificat qui correspond à l'un des certificats que vous avez utilisés lors de l'application dans la Google Play Console.