Ce document explique comment utiliser la console Google Play pour configurer les services Google Play Games pour votre jeu Android. La console de jeu Google fournit un endroit centralisé pour vous permettre de gérer les services de jeu et de configurer les métadonnées pour autoriser et authentifier votre jeu.

Pour ajouter votre jeu à la console Google Play, suivez ces étapes générales:

• Créez un projet de jeu pour votre jeu et spécifiez des détails tels que le nom et la description du jeu.
• Créez et liez les informations d’identification nécessaires pour autoriser et authentifier votre jeu aux services Google Play Games.

Ces étapes sont décrites plus en détail dans les sections ci-dessous.

Étape 1. Connectez-vous à la console Google Play

Pour vous connecter, allez sur la console Google Play.Si vous ne vous êtes pas inscrit à la console Google Play auparavant, vous serez invité à le faire.

Étape 2. Ajoutez votre jeu à la console Google Play

Pour ajouter votre jeu, procédez comme suit :

1. Créez un jeu dans la console Play si vous ne l’avez pas déjà fait. Voirpour plus de détails.
2. Naviguez pour développer > Services de jeux de jeu > Configuration et gestion > Configuration.

3. Spécifiez si votre jeu utilise déjà les API Google (telles que Firebase).Choisir la bonne option est très important.

   • S’il s’agit d’un jeu que vous créez à partir de zéro, ou que vous n’avez jamais configuré les API upGoogle auparavant, choisissez Non, mon jeu n’utilise pas GoogleAPIs. Entrez le nom de votre jeu, puis cliquez sur Créer.
   • S’il s’agit d’un jeu pour lequel vous avez déjà configuré un ou plusieurs GoogleAPIs, choisissez Oui, mon jeu utilise déjà les API Google. Vous verrez une liste de projets de la console Google Cloud pour laquelle vous êtes répertorié comme développeur. Sélectionnez votre projet dans la liste, puis cliquez sur Utiliser.
   • Si vous souhaitez utiliser un projet Play Games Services existant, choisissez Utiliserun projet Play Games Services existant. Vous verrez une liste des projets de services de jeux existants pour votre compte. Sélectionnez le bon projet de jeu dans la liste, puis cliquez sur Utiliser. Ce n’est pas un choix typique, mais vous pouvez le faire si vous créez un nouveau jeu dans PlayConsole pour changer le nom du package, ou si vous avez des versions gratuites et payantes de votre jeu avec des noms de package différents.

4. Un projet de jeu Play Games Services est créé et une entrée correspondante est créée pour vous dans le Google CloudConsole.

5. Dans la section Propriétés, vous pouvez sélectionner Modifier les propriétés et ajouter la description, la catégorie et les éléments graphiques pour votre jeu.

   • Seul le nom d’affichage est requis pour les tests. Les autres champs doivent être remplis avant que vous puissiez publier votre jeu.
   • Le nom d’affichage et la description de votre jeu doivent correspondre à ce que vous avez défini pour la liste Play Store de votre jeu.
   • Pour obtenir des directives sur la création des ressources graphiques, consultez le guide Google Play pour les développeurs et les lignes directrices Google Play – ImageGuidelines.

Étape 3. Générer un ID client OAuth 2.0

Votre jeu doit avoir un ID client OAuth 2.0 pour être authentifié et autorisé à appeler les services Google Play games. Pour configurer un identifiant pour les services PlayGames, qui est l’association entre un identifiant client et votre jeu, utilisez la plate-forme Cloud Google pour créer l’identifiant client. Ensuite, utilisez la console Google Play pourajoutez un identifiant, reliant l’ID client à votre jeu.

Pour des instructions plus détaillées, reportez-vous aux étapes suivantes :

a. Configurez l’écran de consentement OAuth

Vous avez peut-être déjà configuré l’écran de consentement OAuth, mais si vous ne l’avez pas encore fait, la section des informations d’identification affichera un message vous informant que vous ne l’avez pas fait.

Cliquez sur Configurer l’écran de consentement OAuth. Cela ouvre une boîte de dialogue avec d’autres instructions et un lien profond vers la plate-forme Google Cloud. Notez les informations requises décrites à l’étape 2 des instructions de la boîte de dialogue.

Si vous avez terminé la configuration de l’écran de consentement OAuth, cliquez sur Terminé.La console Google Play s’actualise automatiquement, et si la configuration a réussi, vous pourrez créer un identifiant:

b. Créez un identifiant

Afin d’autoriser votre jeu à communiquer avec les services Google Play Games, vous devez créer un identifiant avec un identifiant client OAuth2 autorisé.

Dans la section Informations d’identification, cliquez sur Ajouter des informations d’identification.

Dans l’assistant, choisissez si vous souhaitez créer un identifiant Android (si yourgame APK authentifiera l’utilisateur et utilisera les API PGS) ou un serveur de jeu (si votre serveur de jeu utilisera les API PGS). Suivez les instructions spécifiques au type d’informations d’identification souhaité.

Éviter les problèmes de configuration courants

Pour éviter les erreurs de configuration courantes, assurez-vous de suivre ces recommandations lors de la configuration de votre jeu pour utiliser les services Google Play games.

1. Configurez votre jeu avec la console Google Play Si vous avez créé un ID client Oauth 2.0 pour votre application dans la console Google Cloud, les services Google Play games ne connaîtront pas l’association entre la réussite et les classements du jeu et l’ID client. Pour créer cette association, vous devez créer un identifiant à l’aide de l’ID client Oauth 2.0, comme décrit dans Créer un identifiant. 2. Utilisez l’ID d’application correct dans Android L’ID d’application est une ressource de chaîne requise que vous devez référencer dans votre manifeste Android. La chaîne d’ID d’application se compose uniquement des chiffres (généralement 12 ou plus) au début de l’ID client fourni par la console Google Play. L’ID d’application se trouve en haut de la page de configuration et est étiqueté comme ID de projet sous le nom de votre jeu. 3. Signez votre APK avec le certificat correct Lorsque vous liez votre application Android à votre jeu dans la console Google Play, vous devez utiliser exactement le même nom de package et l’empreinte de certificat que vous avez utilisés pour publier votre application. En cas de non-concordance, les appels aux services Google Play Games échoueront. Vous devez créer deux ID de client, l’un avec l’empreinte du certificat de publication et l’autre avec l’empreinte du certificat de débogage, et utiliser le même nom de package pour les deux. Pour en savoir plus sur la façon de spécifier le certificat de signature dans la console Google Play, Voirconception de vos applications. 4. Lors du développement pour Android, incluez le SDK Play Games en tant que projet de bibliothèque, et non en tant que POT autonome Assurez-vous que le SDK Google Play services est référencé en tant que projet de bibliothèque dans votre projet Android, sinon cela pourrait entraîner des erreurs lorsque votre application ne parvient pas à trouver les ressources des services Google Play. Pour savoir comment configurer votre projet Android pour utiliser les services Google Play, consultez la mise en place des Services Google Play. 5. Connectez-vous avec un compte de testeur pendant le développement Si vous n’avez pas publié les modifications apportées aux paramètres de votre jeu dans la console Google Play, vous risquez de rencontrer des erreurs pendant le test si vous n’êtes pas connecté avec un compte de testeur sur liste blanche. Vous devez toujours activer votre compte Google Play Console Publisher pour les tests. Pour apprendre à gérer les comptes de testeur, voir Activation des comptes pour les tests. 6. À la sortie, publiez d’abord les paramètres des services Play Games avant de publier vos développeurs de jeux peuvent publier accidentellement leur application sans publier les paramètres des services Google Play Games correspondants pour leur application. Cela peut entraîner des erreurs pour les joueurs qui se connectent avec des comptes non testeurs, car l’application ne peut pas référencer les paramètres de jeu corrects. Lors de la sortie de votre jeu, n’oubliez pas de publier d’abord vos paramètres de jeu en utilisant l’option Publier le jeu dans la console Google Play. Pour apprendre à publier vos modifications, suiSsepublier vos modifications de jeu.

Pour des conseils supplémentaires, reportez-vous à ces ressources connexes :

• Top 7 des erreurs de configuration des services de jeux Google Play – Vidéo décrivant les pièges et les scénarios de configuration des services de jeux commonGoogle Play.
• Guide de dépannage Android – Documentation du développeur qui décrit comment résoudre les problèmes lors du développement de jeux Android.

Avant d’aller plus loin, vous devez ajouter des comptes de test à votre jeu comme décrit Dansenabling des comptes pour les tests.Les utilisateurs disposant de comptes de test autorisés auront accès à votre projet de jeu PlayGames Services non publié et pourront tester que vos services Google Play games configurés fonctionnent correctement.

Une fois que vous avez terminé les tâches de configuration initiales décrites ci-dessus, vous pouvez continuer à configurer des fonctionnalités pour votre jeu, telles que les classements et achievements.To en savoir plus, voir Activer les fonctionnalités.