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 de jeu populaires telles que des réussites, des classements et des jeux enregistrés dans vos jeux pour tablette et pour mobile.
Cette formation vous explique comment installer un exemple d'application de jeu pour Android et comment créer rapidement votre propre jeu Android. L'application exemple Type-a-Number Challenge montre comment intégrer des réussites 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 pluscompileSdkVersion
é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 le 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 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.1.0'
}
Guide de l'exemple d'application
Cette formation vous explique comment installer une application de jeu exemple pour Android et comment créer rapidement votre propre jeu Android. L'application exemple Type-a-Number Challenge montre comment intégrer des réussites et des classements à votre jeu.
Étape 1: Téléchargez l'application exemple
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'exemple d'application dans Android Studio, procédez comme suit:
- Téléchargez les exemples Android sur la page de téléchargement des exemples.
- Importez le projet
android-basic-samples
. Ce projet inclutTypeANumber
et d'autres exemples de jeux Android. Pour ce faire dans Android Studio, procédez comme suit :- Cliquez sur File > Import Project (Fichier > Importer un projet).
- Accédez au répertoire dans lequel vous avez téléchargé
android-basic-samples
sur votre ordinateur de développement. Sélectionnez le fichierandroid-basic-samples/build.gradle
, puis cliquez sur OK.
- Dans le module
TypeANumber
, ouvrezAndroidManifest.xml
et remplacez le nom du packagecom.google.example.games.tanc
par un autre nom de package. Le nouveau nom du package ne doit pas commencer parcom.google
,com.example
nicom.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 de votre jeu et de configurer les métadonnées pour les autoriser et les authentifier.
Pour configurer l'exemple de jeu dans la Google Play Console:
- Dans votre navigateur Web, accédez à la Google Play Console, puis connectez-vous. Si vous ne vous êtes pas encore inscrit à la Google Play Console, vous serez invité à le faire.
- Suivez ces instructions pour ajouter votre jeu à la Google Play Console.
- 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.
- Pour les besoins de ce guide du développeur, vous pouvez remplir le formulaire avec les détails de votre 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.
- Suivez ces instructions pour générer un ID client OAuth 2.0 pour votre application Android.
- Lorsque vous associez votre application Android, veillez à spécifier le nom exact du package que vous avez utilisé précédemment lorsque vous avez renommé l'exemple de package.
- Si vous n'en avez pas, vous pouvez utiliser l'assistant Générer un APK signé dans Android Studio pour générer un keystore et un certificat signé. Pour savoir comment exécuter l'assistant de génération d'APK signé, consultez la page Signer votre application dans Android Studio.
- Veillez à noter les informations suivantes pour plus tard :
- Votre ID application: il s'agit d'une chaîne ne contenant que des chiffres (généralement 12 ou plus) au début de votre ID client.
- 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.
- Configurez les succès pour Type-a-Number Challenge :
- Sélectionnez l'onglet Succès dans la Google Play Console.
- Ajoutez les exemples de succès suivants:
Nom Description Instructions spéciales Premier Obtenez un score qui est un nombre premier. Aucune note Humilité Demandez un score de 0. Aucune note Ne t'ennuie pas petit Demandez un score de 9 999 dans les deux modes. Aucune note TRÈS BIEN ! Obtenir un score de 1337 Cette réussite doit être masquée. Je m'ennuie Jouer 10 fois au jeu Cette réussite doit être progressive, et il faut compter 10 étapes pour la débloquer. Je m'ennuie vraiment Jouer 100 fois au jeu. Cette réussite doit être progressive, et il faut compter 100 étapes pour la débloquer. - Enregistrez les ID (longues chaînes alphanumériques) de chaque succès que vous avez créé.
- Configurez des succès adaptés à votre jeu. Pour en savoir plus, consultez les concepts sur les succès et la manière d'implémenter des succès dans Android.
- Configurez les classements pour le défi Type-a-Number :
- Sélectionnez l'onglet Classements dans la Google Play Console.
- Ajoutez deux exemples de classements: l'un intitulé "Scores élevés faciles" et l'autre "Scores élevés". Les deux classements doivent utiliser le format de score entier sans décimales, et le type de classement Plus grand est préférable.
- Enregistrez les identifiants (longues chaînes alphanumériques) de chaque classement que vous avez créé.
- Configurez des classements adaptés à votre jeu. Pour en savoir plus, consultez les concepts des classements et la procédure à suivre pour les implémenter sous Android.
- 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 listés dans la Google Play Console peuvent se connecter. Cependant, une fois qu'une application est publiée, tout le monde est autorisé à se connecter.
É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 les métadonnées des jeux dans le AndroidManifest.xml
.
- Ouvrez
res/values/ids.xml
et remplacez les ID des espaces réservés. Si vous créez un jeu Android à partir de zéro, vous devez d'abord créer ce fichier.- Spécifiez votre ID application dans la ressource
app_id
. - Spécifiez chaque ID de réussite que vous avez créé précédemment dans la ressource
achievement_*
correspondante. - Spécifiez chaque ID de classement que vous avez créé précédemment dans la ressource
leaderboard_*
correspondante.
- Spécifiez votre ID application dans la ressource
- Ouvrez
AndroidManifest.xml
et saisissez le nom du package dans l'attributpackage
de l'élément <manifest
>. Si vous créez un jeu Android à partir de zéro, veillez également à ajouter 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: Testez 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 votre appareil de test:
- 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 > Generate Signed APK (Compiler > Générer un APK signé).
- Installez le fichier APK signé sur votre appareil de test à l'aide de l'outil
adb
. Pour savoir comment installer une application, consultez la section Exécuter l'application sur un appareil.