Cette page a été traduite par l'API Cloud Translation.

Premiers pas avec les services de jeux Play pour Android

Suite à l'arrêt de l'API Google Sign-In, nous allons supprimer le SDK v1 pour les jeux en 2026. Après février 2025, vous ne pourrez plus publier de titres qui viennent d'être intégrés au SDK v1 de Jeux sur Google Play. Nous vous recommandons d'utiliser plutôt le SDK v2 de Jeux.
Bien que les titres existants avec les intégrations de jeux v1 précédentes continuent de fonctionner pendant quelques années, nous vous encourageons à migrer vers la v2 à partir de juin 2025.
Ce guide explique comment utiliser la version 1 du SDK des services de jeux Play. Pour en savoir plus sur la dernière version du SDK, consultez la documentation de la version 2.

Bienvenue dans le 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 d'intégrer facilement des fonctionnalités populaires telles que des récompenses, des classements et des jeux enregistrés dans vos jeux pour tablette et pour mobile.

Cette formation vous guidera pour installer un exemple d'application de jeu pour Android et vous aidera à créer rapidement votre propre jeu Android. L'application exemple Type-a-Number Challenge montre comment intégrer des succès et des classements à 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 votre fichier build.gradle au niveau du projet, ajoutez le dépôt Maven de Google et le dépôt central Maven aux 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 au fichier de compilation Gradle de votre module, qui est généralement app/build.gradle :

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

Guide de l'application exemple

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

Pour ce guide du développeur, vous devez télécharger l'exemple d'application Android Type-a-Number Challenge.

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

Téléchargez les exemples Android sur la page de téléchargement des exemples.
Importez le projet android-basic-samples. Ce projet inclut TypeANumber et d'autres exemples de jeux Android. Pour ce faire dans Android Studio :
1. Cliquez sur File > Import Project (Fichier > Importer un projet).
2. Accédez au répertoire dans lequel vous avez téléchargé android-basic-samples sur votre ordinateur de développement. Sélectionnez le fichier android-basic-samples/build.gradle, puis cliquez sur OK.
Dans le module TypeANumber, ouvrez AndroidManifest.xml et remplacez le nom du package com.google.example.games.tanc par un autre nom de package de votre choix. Le nouveau nom de package ne doit pas commencer par com.google, com.example ou com.android.

Étape 2 : Configurez le 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 configurer l'exemple de jeu dans la Google Play Console :

Dans votre navigateur Web, accédez à la Google Play Console et connectez-vous. Si vous ne vous êtes pas encore inscrit sur la Google Play Console, un message vous invitant à le faire s'affiche à l'écran.
Suivez ces instructions pour ajouter votre jeu à la Google Play Console.
1. À la question vous demandant si vous utilisez des API Google dans votre application, sélectionnez Je n'utilise pas d'API Google dans mon jeu.
2. Pour les besoins de ce guide du développeur, vous pouvez remplir le formulaire avec les informations de votre jeu. Pour plus de commodité, vous pouvez utiliser les icônes et captures d'écran d'espace réservé fournies sur la page Téléchargements.
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 nom de package exact que vous avez utilisé précédemment lorsque vous avez renommé l'exemple de package.
2. Vous pouvez utiliser l'assistant "Générer un fichier APK signé" dans Android Studio pour générer un keystore et un certificat signé si vous n'en avez pas déjà un. Pour savoir comment exécuter l'assistant "Générer un APK signé", consultez Signer votre application dans Android Studio.
Veillez à noter les informations suivantes pour plus tard :
1. L'ID de votre application : il s'agit d'une chaîne composée uniquement de chiffres (au moins 12, généralement) placés en tête de votre ID de client.
2. Votre certificat de signature : notez le certificat que vous avez utilisé lors de la configuration de votre accès à l'API (le certificat dont vous avez fourni l'empreinte SHA1). Vous devez utiliser le même certificat pour signer votre application lorsque vous la testez ou la publiez.

Configurer les succès pour le défi "Saisir un nombre" :

Sélectionnez l'onglet Succès dans la Google Play Console.

Ajoutez les exemples de réussite suivants :

Nom	Description	Instructions spéciales
Prem	Obtenir un score correspondant à un nombre premier	Aucun(e)
Humble	Obtenir un score de 0	Aucun(e)
Ne t'enflamme pas	Obtenir un score de 9 999 dans n'importe quel mode	Aucun(e)
TROP FORT !	Obtenir un score de 1 337	Cette réussite doit être masquée.
On s'ennuie	Jouer 10 fois au jeu	Cette réussite doit être progressive, et est déverrouillée au bout de 10 étapes.
On s'ennuie, c'est mortel	Jouer 100 fois au jeu	Cette réussite doit être progressive, et est déverrouillée au bout de 100 étapes.

Enregistrez les ID (longues chaînes alphanumériques) de chaque réussite que vous avez créée.
Configurez les réussites adaptées à votre jeu. Pour en savoir plus, consultez les concepts liés aux succès et comment implémenter des succès dans Android.

Configurez les classements pour le défi "Saisir un nombre" :
1. Sélectionnez l'onglet Classements dans la Google Play Console.
2. Ajoutez deux exemples de classements : l'un nommé "Easy High Scores" (Records faciles) et l'autre "Hard High Scores" (Records difficiles). Les deux classements doivent utiliser le format de score "Integer" (Entier) avec 0 décimale et un type de classement Larger is better (Plus élevé est mieux).
3. Enregistrez les identifiants (longues chaînes alphanumériques) de chaque classement que vous créez.
4. Configurez les classements adaptés à votre jeu. Pour en savoir plus, consultez les concepts liés aux classements et découvrez comment implémenter des classements dans Android.
Ajoutez les comptes de test correspondant à 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 listés dans la Google Play Console peuvent se connecter. Toutefois, une fois l'application publiée, tout le monde peut se connecter.

Étape 3 : Modifier votre code

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

Ouvrez res/values/ids.xml et remplacez les ID d'espace réservé. Si vous créez un jeu Android à partir de zéro, vous devrez d'abord créer ce fichier.
1. Spécifiez l'ID de votre application dans la ressource app_id.
2. Spécifiez chaque ID de succès que vous avez créé précédemment dans la ressource achievement_* correspondante.
3. Spécifiez chaque ID de classement que vous avez créé précédemment dans la ressource leaderboard_* correspondante.
Ouvrez AndroidManifest.xml et saisissez le nom de votre package dans l'attribut package de l'élément <manifest>. Si vous créez un jeu Android à partir de zéro, assurez-vous d'ajouter également le code suivant dans l'élément <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 : Tester votre jeu

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

Pour exécuter votre jeu sur un appareil de test, suivez les étapes ci-dessous :

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