Les succès peuvent être un excellent moyen d'augmenter l'engagement utilisateur au sein de votre jeu. Vous pouvez implémenter des succès dans votre jeu pour encourager les joueurs à tester des fonctionnalités qu'ils n'utiliseraient pas normalement ou à jouer à votre jeu d'une manière qui diffère de leurs habitudes. Les succès peuvent également être un moyen amusant pour les joueurs de comparer leurs progrès et de participer à des compétitions bon enfant.
Pour découvrir comment implémenter des succès pour votre plate-forme, consultez la section Implémentations client.
Attributs
Pour comprendre le fonctionnement des succès, vous devez connaître certains des attributs qui leur sont associés.
Principes de base
Ces éléments de base sont associés à chaque succès :
- L'ID est une chaîne unique générée par la Google Play Console. Cet identifiant unique vous permettra de faire référence au succès dans les clients de votre jeu.
- Name : nom court donné au succès (par exemple, "Maître des tartes"). Il peut compter jusqu'à 100 caractères.
- Description : brève description du succès. C'est généralement indique à votre joueur comment obtenir la réussite (par exemple, "Faire une tarte au citron meringuée") avant le coucher du soleil"). Elle peut compter jusqu'à 500 caractères.
- Icon : icône carrée associée à votre succès. Pour découvrir les bonnes pratiques à adopter lors de la création d'icônes de succès, consultez la section Consignes relatives aux icônes.
- List order : correspond à l'ordre d'affichage des succès verrouillés lorsqu'un joueur voit les succès associés à votre jeu. Vous pouvez placer vos succès dans n'importe quel ordre. Les succès déverrouillés apparaissent en haut de la liste, dans l'ordre dans lequel ils ont été déverrouillés.
État
Les succès peuvent être associés à l'un des trois états ci-dessous :
- Un succès hidden (masqué) signifie que le joueur ne peut pas voir les détails qui lui sont associés. Les services de jeux Google Play fournissent un espace réservé générique une description et une icône de la réussite lorsqu'elle est masquée. Nous vous recommandons de masquer un succès s'il contient un spoiler que vous ne souhaitez pas dévoiler trop tôt à propos de votre jeu (par exemple, "Découvrez que vous avez toujours été un fantôme !").
- Une réussite révélée signifie que le joueur a connaissance de la réussite, ne l'a pas encore mérité. La plupart des succès commencent à l'état "révélé".
- Une réussite déverrouillée signifie que le joueur a gagné la réussite. Un succès peut être déverrouillé hors connexion. Lorsque le jeu se connecte, il est synchronisé avec les services de jeux Google Play pour mettre à jour l'état de déverrouillage de la réussite.
Réussites progressives
Les succès peuvent être standard ou incremental (progressifs). Généralement, une réussite progressive implique que le joueur progresse progressivement pour gagner la réussite sur une période plus longue. Au fur et à mesure que le joueur progresse vers un succès progressif, vous pouvez signaler la progression partielle du joueur aux services de jeux Google Play. Le service Google Play assure le suivi des informations de progression et avertit le jeu lorsque le joueur a atteint les critères nécessaires pour déverrouiller la réussite et indique au joueur où il en est pour atteindre cet objectif.
![Un exemple de succès progressif montrant la progression du joueur à 40 %](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/achievementIncremental.png?authuser=7&hl=fr)
Les succès progressifs sont cumulables d'une session de jeu à une autre, et la progression ne peut pas être supprimée ni réinitialisée au sein du jeu. Par exemple, "Remportez 50 parties". serait considéré comme une augmentation réussite. "Remportez 3 matchs d'affilée" ce n'est pas le cas, car la progression du joueur se réinitialisent lorsqu'ils perdent une partie. "Gagne 5 000 jetons de poker" ne sont pas non plus éligibles, car les joueurs peuvent gagner ou perdre des jetons en jouant. Pour les deux dernières réussites, c'est à vous de suivre les performances d'affilée du joueur état ou nombre total de chips et de débloquer des succès standards lorsque le joueur les obtient.
Lorsque vous créez un succès progressif, vous devez définir le nombre total d'étapes requises pour le déverrouiller (il doit s'agir d'un nombre compris entre 2 et 10 000). En tant que l'utilisateur progresse vers le déverrouillage de la réussite, vous devez Indiquer le nombre d'étapes supplémentaires que l'utilisateur a effectuées auprès des services de jeux Google Play Lorsque le nombre total d'étapes atteint la valeur de déverrouillage, le succès est déverrouillé (même s'il était masqué). Vous n'avez pas besoin d'enregistrer l'avancée progressive de l'utilisateur.
Points
Les succès sont associés à une valeur en points. Le score du joueur doit être un multiple de 5 et un jeu ne peut jamais atteindre un total de plus de 1 000 points pour l'ensemble de (il peut en contenir moins). De plus, aucune réussite unique ne peut ont plus de 200 points.
Gagner des points d'expérience (XP)
Les joueurs peuvent gagner des niveaux dans leur profil de joueur lorsqu'ils obtiennent des succès dans les jeux compatibles avec Play Jeux. Pour chaque point associé à un succès, le joueur gagne 100 points d'expérience (XP) lorsqu'il l'obtient. Autrement dit :
XP for an achievement = 100 * (point value for the achievement)
Les services de jeux Play suivent les XP gagnés par chaque joueur et envoient une notification à l'application Google Play Jeux lorsque le joueur a gagné suffisamment de points pour passer au niveau supérieur. Les joueurs peuvent consulter leur niveau et leur historique d'XP depuis leur page de profil dans l'application Google Play Jeux.
Nombre minimal de succès
Un jeu qui intègre des réussites doit avoir au moins cinq réussites avant d'être publié. Vous pouvez effectuer un test avec moins de cinq réussites, mais il est recommandé d'en avoir au moins cinq. avant de publier votre jeu.
Nombre maximal de succès
Le nombre de succès est limité par le nombre et la distribution des points. Avec un nombre maximal de points de 1 000 et 5 points par succès, le nombre maximal de succès est de 200. Toutefois, si plus de points sont attribués à certains succès, le nombre de succès disponibles diminue en conséquence.
Directives concernant les icônes
Les icônes doivent être créées sous forme de fichiers PNG ou JPG de 512 x 512 px. Il vous suffit de nous fournir avec l'icône de la réussite déverrouillée. Nous générer automatiquement une version en nuances de gris pour l'icône affichée. Pour cette raison, nous vous recommandons d'inclure des éléments colorés dans vos icônes de réussite, afin que vos utilisateurs puissent distinguer facilement les réussites révélées des réussites déverrouillées.
Lorsqu'une icône de succès est affichée dans un toast Android, elle est superposée à un cercle et ses coins externes sont masqués. Assurez-vous que l'apparence de votre icône est toujours correcte dans ces circonstances.
![Un exemple d'icône de succès placée dans un cercle.](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/achievementIconExample.png?authuser=7&hl=fr)
La même icône étant utilisée pour toutes les langues, nous vous déconseillons d'y inclure du texte ou du contenu localisé.
Créer une réussite
Pour un nouveau jeu
Pour créer un succès pour un nouveau jeu ou un jeu non publié, accédez à la Dans la Google Play Console, sélectionnez votre jeu dans l'onglet Jeux avec services de jeux.
Sélectionnez l'onglet Succès sur la gauche, puis cliquez sur le bouton Ajouter un succès.
![Le bouton "Ajouter un succès" dans le panneau principal des succès](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/achievementAddButton.png?authuser=7&hl=fr)
Ensuite, il vous suffit de fournir les informations requises pour ce succès.
![Un exemple de formulaire de succès rempli pour le succès "Dernière place".](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/achievementSampleForm.png?authuser=7&hl=fr)
Cliquez sur Enregistrer, et votre succès passera en mode "Prêt pour la publication". Une fois que vous aurez publié votre jeu, tous les succès associés seront publiés.
Pour un jeu publié
Pour créer un succès supplémentaire pour un jeu déjà publié, suivez les étapes ci-dessus. La seule différence est que le bouton Enregistrer sera renommé en Enregistrer comme brouillon et que votre succès sera en mode "Prêt pour les tests". Pour savoir comment tester une version mise à jour d'un jeu, consultez la page Publier les modifications apportées à votre jeu.
Une fois que vous avez testé votre succès et que vous en êtes satisfait, vous pouvez publier à nouveau votre jeu avec les nouveaux succès, qui seront ensuite accessibles au monde entier.
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 vous avez utilisé lors de la création du succès s'affiche. Vous pouvez modifier tous les champs que vous souhaitez.
Lorsque vous avez terminé de modifier un succès, cliquez sur le bouton Enregistrer comme brouillon. Le nouveau succès passera à l'étape "Prêt pour les tests", et vous pourrez le tester. S'il fonctionne correctement, sélectionnez Publier à nouveau dans la liste déroulante. Votre jeu et tous vos succès mis à jour seront alors publiés à nouveau et seront accessibles au public.
Annuler une modification
Si vous décidez que vous n'aimez pas votre réussite actuelle et que vous voulez revenir à votre réussite telle qu'elle était auparavant, sélectionnez Rétablir dans le dans la liste déroulante de la Google Play Console, et toutes vos réussites seront rétablies version publiée.
Supprimer une réussite
Une fois votre succès publié, il ne peut pas être supprimé.
Pour supprimer un succès dont l'état est prépublié, 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 succès à l'état de brouillon.
- Pour réinitialiser des réussites dans la Google Play Console, cliquez sur le bouton intitulé Réinitialiser la progression vers la réussite au bas du formulaire de cet événement
- Pour réinitialiser les données de succès de façon programmatique, appelez les méthodes
Achievements
de l'API Management.
Ajouter des traductions pour les réussites
Vous pouvez spécifier vos propres traductions pour les succès associés à votre jeu. Avant de commencer, assurez-vous de suivre la procédure décrite dans la section Ajouter des traductions pour votre jeu. Vous devez également avoir créé un ou plusieurs succès pour votre jeu.
Pour ajouter vos propres traductions de succès, ouvrez l'onglet Succès de votre jeu dans la Google Play Console, puis sélectionnez un succès existant. Le page d'informations sur les réussites, sélectionnez l'onglet d'une langue que vous avez précédemment ajoutée dans l'onglet Détails du jeu. Sur la page d'informations sur les succès pour cette langue, modifiez le formulaire avec vos traductions pour cette réussite. Cliquez sur Enregistrer pour enregistrer la traduction des informations relatives à la réussite.
Implémentations client
Pour découvrir comment implémenter des succès pour votre plate-forme, consultez les ressources suivantes: