Les services de jeux Google Play vous permettent d'ajouter des fonctionnalités multijoueurs et de réseaux sociaux attrayantes à vos jeux.
Sélectionnez une fonctionnalité ci-dessous pour en connaître les bases et consulter la documentation relative à la mise en œuvre des services de jeux Google Play.
Premiers pas
Pour savoir comment intégrer le SDK des services de jeux Google Play et obtenir des instructions ainsi que des exemples qui vous aideront à vous lancer, consultez le site Google Developers.
Pour utiliser les services de jeux Google Play, vous devez créer une fiche de jeu dans la Play Console. Votre fiche de jeu est différente de la fiche Play Store de votre application.
Pour ajouter une fiche de jeu :
- Ouvrez la Google Play Console.
- Accédez à Configuration
> Projets de jeu.
- En haut à droite, cliquez sur Ajouter un jeu.
> Projets de jeu.Fonctionnalités
Avec les réussites, vous pouvez contribuer à fidéliser les joueurs en leur attribuant des récompenses lorsqu'ils atteignent des objectifs fixés dans votre jeu. Les joueurs peuvent obtenir des points d'expérience (XP) lorsqu'ils remportent des réussites dans votre jeu.
Consultez le site Google Developers pour en savoir plus sur les réussites.
Remarque : Une fois publiées, les réussites ne peuvent pas être supprimées.
Il existe deux manières de créer des réussites pour la première fois dans la Google Play Console :
- Créer une réussite : ajoutez les définitions et les métadonnées d'une réussite après l'autre.
- Importer des réussites : importez les définitions et d'autres métadonnées de plusieurs réussites en une seule fois.
Remarque : Utilisez des API pour débloquer des réussites pour le joueur connecté. Cela révèlera les réussites cachées au joueur, le cas échéant.
Pour créer une réussite pour un nouveau jeu non publié, procédez comme suit dans la Google Play Console :
- Dans la Google Play Console, sélectionnez un jeu.
- Sur la page Services de jeux Play - Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), sélectionnez Créer une réussite.
- Sur la page Ajouter des réussites, remplissez le formulaire.
- Cliquez sur Enregistrer comme brouillon.
Une fois votre réussite créée, vous devez publier votre jeu.
Ajouter d'autres réussites
Si vous avez déjà des réussites et que vous souhaitez en ajouter :
-
Dans la Google Play Console, sélectionnez un jeu.
-
Sur la page Services de jeux Play - page Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), sélectionnez Ajouter des réussites.
Pour ajouter plusieurs réussites en même temps à votre jeu, procédez comme suit :
1. Créez un fichier ZIP contenant vos réussites.
1. 1 Importez le fichier.
Pour en savoir plus sur le fichier ZIP, consultez les exigences concernant les fichiers ZIP.
Pour importer des réussites :
- Dans la Google Play Console, sélectionnez un jeu.
- Sur la page Services de jeux Play - page Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), sélectionnez Importer des réussites.
- Sur la page Importer des réussites, cliquez sur Importer.
- Sélectionnez le fichier ZIP à importer.
- Cliquez sur Enregistrer comme brouillon.
- Une fois que vous avez importé des réussites, vous devez publier votre jeu.
Modifier une réussite
Pour modifier une réussite que vous avez déjà créée, sélectionnez-la dans l'onglet Réussites de la Google Play Console. À ce stade, le même formulaire que celui utilisé lors de la création de la réussite s'affiche. Vous pouvez modifier tous les champs que vous souhaitez.
Lorsque vous avez terminé de modifier une réussite, cliquez sur le bouton Enregistrer comme brouillon. La réussite mise à jour passera à l'étape "Prête pour les tests", et vous pourrez la tester. Si elle fonctionne correctement, sélectionnez Publier à nouveau dans la liste déroulante. Votre jeu et toutes vos réussites mises à jour seront alors publiés à nouveau et accessibles au public.
Remarque : Une fois qu'une réussite est publiée, son état initial (masquée ou révélée) et son type (progressif ou standard) sont fixes et ne peuvent pas être modifiés.
Annuler une modification
Supprimer une réussite
Une fois votre réussite publiée, elle ne peut pas être supprimée.
Pour supprimer une réussite dont l'état est "prépubliée", vous devez cliquer sur le bouton Supprimer situé au bas du formulaire correspondant.
Réinitialiser une réussite
Vous ne pouvez réinitialiser les données de progression des joueurs que pour les réussites à l'état de brouillon.
- Pour réinitialiser les réussites dans la Google Play Console, cliquez sur le bouton Réinitialiser la progression des réussites en bas du formulaire de cet événement.
- Pour réinitialiser les données de réussites de façon programmatique, appelez les méthodes de l'API Management qui concernent les réussites.
Exigences concernant les icônes
Les icônes doivent être créées sous forme de fichiers PNG, JPEG ou JPG de 512 x 512 px. Il vous suffit de nous fournir l'icône de la réussite déverrouillée. Nous générerons ensuite automatiquement une version en nuances de gris pour l'icône révélée. C'est pourquoi nous vous recommandons d'inclure dans vos icônes des éléments de couleur, afin que vos utilisateurs puissent distinguer facilement les réussites révélées de celles déverrouillées.
Lorsqu'une icône de réussite s'affiche dans un toast Android, elle est recouverte d'un cercle, et ses coins extérieurs sont masqués. Veillez à ce que l'icône s'affiche toujours correctement dans ces circonstances.
Exemple d'icône de réussite.
Étant donné que la même icône est utilisée pour tous les paramètres régionaux, nous vous déconseillons d'y inclure du texte ou du contenu localisé.
Exigences concernant les fichiers ZIP
Vous pouvez importer plusieurs réussites à la fois à l'aide d'un fichier ZIP. Reportez-vous au tableau pour connaître les noms de fichiers exacts à utiliser dans votre fichier ZIP :
|
Nom de fichier |
Obligatoire ou facultatif |
Valeurs acceptées |
|
|
Obligatoire |
Métadonnées de chaque réussite. Voir la section Attributs. |
|
|
Facultatif |
Fournit des traductions pour les noms et les descriptions des réussites. |
|
|
Facultatif |
Fait correspondre les réussites à leurs fichiers d'icônes. |
|
Facultatif |
Icônes au format PNG, JPEG ou JPG. |
Exigences concernant les fichiers ZIP :
- Aucun sous-répertoire.
- Noms de fichiers uniques.
- Fichiers au format CSV, PNG, JPEG ou JPG uniquement.
- Le fichier CSV ne doit pas comporter de ligne d'en-tête.
- La taille de chaque fichier doit être inférieure à 1 Mo.
- Le nombre total de fichiers ne doit pas dépasser 203.
- La taille totale du fichier ZIP ne doit pas dépasser 200 Mo.
Format d'AchievementsMetadata.csv
Le fichier AchievementsMetadata.csv contient les métadonnées de chaque réussite. Il doit inclure les informations sous la forme de valeurs séparées par une virgule et dans l'ordre suivant :
Ces champs sont décrits dans le tableau suivant :
|
En-têtes des colonnes du fichier CSV |
Obligatoire ou facultatif |
Valeurs acceptées |
|
Nom |
Obligatoire |
100 caractères maximum |
|
Description |
Facultatif |
500 caractères maximum |
|
Valeur incrémentielle |
Facultatif |
"True" ou "False" |
|
Étapes nécessaires |
Obligatoire si la valeur "Valeur incrémentielle" est définie sur "True". |
Nombre (sans fraction ni décimale) |
|
État initial |
Obligatoire |
Masquée ou révélée |
|
Points |
Obligatoire |
Multiple de 5, compris entre 5 et 200 |
|
Ordre dans la liste |
Facultatif |
Nombre (supérieur à zéro, sans fraction ni décimale) |
Exigences concernant le fichier AchievementsMetadata.csv :
- Chaque ligne doit comporter sept valeurs. Si vous souhaitez omettre une valeur, ne la renseignez pas.
- Les champs "Nom" et "Description" sont utilisés comme paramètre régional par défaut.
- Le champ "Nom" doit être unique parmi toutes les réussites.
- Les champs suivants ne doivent pas contenir de virgules : "Nom" et "Description".
Exemple de fichier AchievementsMetadata.csv :
Achievement1,,True,100,Hidden,5,20
Achievement2,,False,,Revealed,10,30
Format d'AchievementsLocalizations.csv
Le fichier AchievementsLocalizations.csv est un fichier facultatif qui configure toutes les données nécessaires pour décrire chaque réussite aux utilisateurs dans différentes langues. Les réussites sont traduites en fonction des langues spécifiées pour le jeu.
Il doit inclure les informations sous la forme de valeurs séparées par une virgule et dans l'ordre suivant :
Ces champs sont décrits dans le tableau suivant :
|
En-têtes des colonnes du fichier CSV |
Obligatoire ou facultatif |
Description |
Valeurs acceptées |
|
Nom |
Obligatoire |
Doit correspondre à la colonne "Nom" du fichier |
100 caractères maximum |
|
Nom localisé |
Obligatoire |
Nom localisé de la réussite. |
100 caractères maximum |
|
Description localisée |
Facultatif |
Description localisée de la réussite dans le paramètre régional spécifié. |
500 caractères maximum |
|
Paramètres régionaux |
Obligatoire |
Code des paramètres régionaux, par exemple en-US. |
Ajoutez des traductions pour votre jeu avant de spécifier un paramètre régional. Notez que vous ne pouvez pas spécifier le paramètre régional par défaut. Vous trouverez les codes des paramètres régionaux compatibles dans la liste des langues disponibles. |
Exigences concernant le fichier AchievementsLocalizations.csv :
- Les noms des réussites d'un jeu doivent être uniques au sein d'un même paramètre régional. Si un jeu est compatible avec les paramètres régionaux en-US et fr-FR, une réussite nommée "Achievement1" pour en-US peut également être nommée "Achievement1" pour fr-FR.
- Chaque ligne doit comporter quatre valeurs. Si vous souhaitez omettre la valeur de la description localisée, ne la renseignez pas.
Exemple de fichier AchievementsLocalizations.csv :
Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE
Format d'AchievementsIconMappings.csv
Le fichier AchievementsIconMappings.csv est un fichier facultatif qui permet de faire correspondre vos réussites avec les icônes correspondantes. Il doit inclure les informations sous la forme de valeurs séparées par une virgule et dans l'ordre suivant :
Ces champs sont décrits dans le tableau suivant :
|
En-têtes des colonnes du fichier CSV |
Obligatoire ou facultatif |
Description |
|
Nom |
Obligatoire |
Doit correspondre à la colonne "Nom" du fichier |
|
Nom de fichier de l'icône |
Obligatoire |
Nom de votre fichier d'icône. |
Exigences concernant le fichier AchievementsIconMappings.csv :
- Chaque ligne doit comporter deux valeurs.
- Les fichiers d'icônes peuvent être au format PNG ou JPEG.
Exemple de fichier AchievementsIconMappings.csv :
Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg
AchievementsIconMappings.csv doivent exister dans l'archive ZIP actuelle que vous importez. Pour en savoir plus, consultez les exigences concernant les icônes.Vous pouvez ajouter vos propres traductions pour les réussites associées à votre jeu. Assurez-vous simplement d'avoir d'abord suivi les étapes décrites dans la section Ajouter des traductions pour votre jeu.
Vous pouvez ajouter des traductions pour votre jeu de deux manières :
- Vous pouvez utiliser l'option Importer des réussites pour importer les traductions de plusieurs nouvelles réussites à la fois. Vous ne pouvez pas utiliser cette option pour importer des traductions pour des réussites existantes.
- Vous pouvez ajouter des traductions pour chaque réussite de votre jeu. Pour ajouter votre propre traduction pour chaque réussite :
- Dans la Google Play Console, ouvrez l'onglet Réussites de votre jeu, puis sélectionnez une réussite existante.
- Sur la page d'informations de la réussite, sélectionnez l'onglet d'une langue que vous avez précédemment ajoutée dans l'onglet Détails sur le jeu.
- Sur la page d'informations de la réussite pour cette langue, ajoutez vos traductions au formulaire.
- Cliquez sur Enregistrer pour enregistrer la traduction des informations concernant la réussite.
Les classements permettent aux joueurs de votre jeu de comparer leurs scores avec leurs amis et de se mesurer aux meilleurs joueurs.
Remarque : Vous ne pouvez pas réinitialiser les scores des classements, mais vous pouvez supprimer ou masquer les classements à tout moment.
Pour masquer des scores suspects dans les classements, vous pouvez activer la protection contre la falsification des classements sur la page Classements de votre jeu dans la Play Console.
Créer un classement
Pour créer un classement pour un nouveau jeu non publié, procédez comme suit :
- Dans la Google Play Console, sélectionnez un jeu.
- Accédez à Croissance > Services de jeux Play > Configuration et Gestion > Classements, puis cliquez sur le bouton Créer un classement.
- Fournissez les informations requises pour ce classement.
- Cliquez sur Enregistrer comme brouillon pour que votre classement soit disponible à l'état "Brouillon".
- Une fois votre jeu publié, tous les classements du jeu le sont également.
Créer un classement pour un jeu publié
Si vous souhaitez créer un classement supplémentaire pour un jeu qui a déjà été publié, suivez la même procédure que ci-dessus. Pour découvrir comment tester une version mise à jour d'un jeu, consultez la section Publier les modifications apportées à votre jeu.
Une fois que vous avez testé votre classement et qu'il vous convient, vous pouvez publier à nouveau votre jeu avec les nouveaux classements, qui seront ensuite accessibles à tous.
Modifier un classement
Pour modifier un classement que vous avez déjà créé, cliquez sur celui-ci dans l'onglet Classements de la Google Play Console. À ce stade, le même formulaire que celui utilisé lors de la création du classement s'affiche. Vous pouvez modifier tous les champs que vous souhaitez.
Lorsque vous avez fini de modifier un classement, cliquez sur le bouton Enregistrer comme brouillon. Le nouveau classement passera à l'état "Brouillon", ce qui vous permettra de le tester.
Si tout fonctionne comme prévu, sélectionnez Publier les modifications en haut du formulaire de classement. Vous pourrez alors publier à nouveau le jeu, ainsi que tous les classements mis à jour.
Annuler une modification
Supprimer un classement
Vous pouvez supprimer les classements qui sont à l'état "Brouillon", ainsi que ceux qui ont déjà été publiés. Pour supprimer un classement dans la Google Play Console, accédez au formulaire correspondant, puis cliquez sur Supprimer le classement en haut du formulaire.
Vous pouvez également appeler Players.hide pour masquer le classement d'un joueur dans l'application.
Réinitialiser un classement
Vous ne pouvez réinitialiser les données de progression des joueurs que pour les classements à l'état de brouillon.
- Pour réinitialiser les classements dans la Google Play Console, cliquez sur Réinitialiser la progression en haut du formulaire.
- Pour réinitialiser les données du classement de façon programmatique, appelez les Scoresmethods de l'API Management.
Ajouter des traductions pour les classements
Vous pouvez ajouter vos propres traductions pour les classements associés à votre jeu. Assurez-vous simplement d'avoir d'abord suivi les étapes décrites dans la section Ajouter des traductions pour votre jeu. Vous devez également avoir créé un ou plusieurs classements pour votre jeu.
Afin d'ajouter vos propres traductions pour les classements, ouvrez l'onglet Classements de votre jeu dans la Google Play Console, puis sélectionnez un classement existant. Sur sa page d'informations, cliquez sur l'onglet d'une langue que vous avez précédemment ajoutée dans l'onglet Détails sur le jeu. Sur la page d'informations du classement pour cette langue, ajoutez vos traductions au formulaire. Cliquez sur Enregistrer pour enregistrer la traduction des informations à propos du jeu.
Masquer les scores d'un classement
Les services de jeux Google Play fournissent une fonctionnalité de protection contre la falsification des classements. Celle-ci recherche les scores potentiellement trompeurs et les masque automatiquement. Cette fonctionnalité n'est disponible que pour les jeux Android.
La protection contre la falsification est activée par défaut pour les classements que vous créez pour votre jeu Android, mais elle est désactivée pour les classements existants. Si vous souhaitez l'activer pour les classements qui ont déjà été publiés, procédez comme suit :
- Dans la Google Play Console, ouvrez l'onglet Services de jeux, puis sélectionnez votre jeu dans la liste.
- Ouvrez l'onglet Classements, puis sélectionnez le classement pour lequel vous souhaitez activer la protection contre la falsification.
- Activez l'option Activer la protection contre la falsification des classements.
- Cliquez sur Save.
- Publiez votre jeu.
Une fois que la protection contre la falsification est activée pour un classement dans la Google Play Console, un délai de 24 heures peut être nécessaire pour qu'elle entre en vigueur. Les scores envoyés avant l'activation de la protection contre la falsification ne sont pas masqués rétroactivement.
Dans certains cas, vous pouvez désactiver la protection contre la falsification (par exemple, si votre jeu s'exécute également sur le Web en plus d'Android et que ses classements sont partagés sur ces plates-formes).
Consultez le site Google Developers pour savoir comment implémenter le service Jeux enregistrés.
Activer le service Jeux enregistrés
Pour activer le service Jeux enregistrés, procédez comme suit dans la Play Console :
- Dans la Google Play Console, sélectionnez un jeu.
- Sur la page Services de jeux Play - Configuration (Croissance > Services de jeux Play > Configuration et gestion > Configuration), sélectionnez Modifier les propriétés.
- Activez l'option Jeux enregistrés.
- Cliquez sur Enregistrer.
Une fois les étapes ci-dessus terminées, l'activation du service Jeux enregistrés par les services de jeux Google Play peut prendre jusqu'à 24 heures. Si vous souhaitez tester le service Jeux enregistrés immédiatement, effacez manuellement les données de l'application Services Google Play sur votre appareil de test.
Pour effacer les données mises en cache sur Android, ouvrez les Paramètres > Applications > Services Google Play, cliquez sur Gérer l'espace, puis sur Effacer toutes les données.
Pour en savoir plus sur le service Jeux enregistrés, consultez le guide des jeux enregistrés.
Ajouter des traductions
Vous pouvez ajouter vos propres traductions des informations à propos du jeu, y compris le nom à afficher, la description du jeu et les assets graphiques. Vous pouvez également ajouter vos propres traductions des réussites et des classements associés à votre jeu.
Pour ajouter vos propres traductions des informations à propos du jeu :
- Dans la Google Play Console, sélectionnez un jeu.
- Accédez à la page Services de jeux Play - Configuration (Croissance > Services de jeux Play > Configuration et gestion > Configuration).
- Sélectionnez Modifier les propriétés.
- Sélectionnez Gérer les traductions > Gérer vos traductions.
- Sélectionnez les langues pour lesquelles vous allez fournir des traductions, puis cliquez sur Appliquer pour confirmer votre choix. Sur la page Propriétés, les langues que vous avez sélectionnées deviennent disponibles dans le sélecteur de langue.
- Sélectionnez la langue que vous souhaitez modifier dans le sélecteur de langue, puis modifiez le formulaire avec vos traductions pour le nom à afficher, la description et les assets graphiques.
- Cliquez sur Enregistrer les modifications pour enregistrer la traduction des informations à propos du jeu.
Pour en savoir plus sur l'ajout de traductions pour les réussites et les classements, consultez les guides concernant les réussites et les classements.
Lors de l'affichage des chaînes correspondant aux informations à propos du jeu, aux classements et aux réussites, la langue compatible avec le jeu la plus proche de la langue demandée par le joueur est sélectionnée par les services de jeux Play. Par exemple, si les préférences de langue de l'appareil sont définies sur le français (Canada) (fr-CA), mais que le jeu n'accepte que l'anglais (États-Unis) (en-US) et le français (France) (fr-FR), les services de jeux Play affichent les chaînes fr-FR, car il s'agit de la langue la plus proche.
Accorder des droits de modification aux utilisateurs
Pour automatiser la configuration de l'application et intégrer les releases dans les outils et les processus automatisés existants, vous pouvez utiliser l'API Google Play Games Services Publishing. Voici comment activer l'accès à l'API Google Play Games Services Publishing dans la Play Console :
- Ouvrez la Google Play Console.
- Accédez à Configuration
- Créez un projet associé, si ce n'est déjà fait.
- À côté de l'option "API Games Configuration", cliquez sur le bouton Activer.
Gérer plusieurs utilisateurs
Si plusieurs utilisateurs gèrent des jeux depuis votre compte de développeur, vous devez gérer les autorisations à partir de la page Utilisateurs et autorisations de la Play Console.