Passer au contenu principal
Cette rubrique décrit les différences entre les succès basés sur les événements et les succès gérés par le titre. Les succès basés sur les événements étaient auparavant appelés « succès alimentés par le cloud » ou « Achievements 2013 ». Les succès gérés par le titre étaient auparavant appelés « Achievements 2017 ». Les succès gérés par le titre sont plus simples que les succès basés sur les événements : ils utilisent des appels directs, une configuration simple et un dépannage local. Le service Achievements géré par le titre utilise un modèle d’appel direct pour déverrouiller les succès des nouveaux jeux utilisant les services XBOX sur XBOX, Windows 10, Android et iOS.
[!NOTE] Nous vous recommandons d’utiliser les succès gérés par le titre pour configurer les nouveaux titres.

Introduction

Les succès basés sur les événements vous permettent d’alimenter les données de vos fonctionnalités des services XBOX, telles que les statistiques utilisateur, les succès, la présence enrichie et le multijoueur, en envoyant des événements de télémétrie en jeu. Cela présente de nombreux avantages. Par exemple, un seul événement peut mettre à jour les données de plusieurs fonctionnalités des services XBOX, la configuration des services XBOX réside sur le serveur plutôt que dans le client, et bien d’autres avantages encore. Au cours des années qui ont suivi la sortie des succès basés sur les événements, les développeurs ont régulièrement fait part des commentaires suivants.
  1. Déverrouiller les succès avec un modèle d’appel direct serait plus simple. De nombreux développeurs créent des jeux pour plusieurs plateformes et générations, et un modèle d’appel direct facilite la prise en charge de plusieurs plateformes. La prise en charge d’appels de déverrouillage directs faciliterait leur développement de jeux multiplateformes et réduirait le temps de développement.
  2. La configuration des succès basés sur les événements est trop complexe. Avec le service Achievements basé sur les événements, la logique de déverrouillage d’un succès doit être configurée dans les services XBOX afin que ceux-ci sachent interpréter les données statistiques du titre et à quel moment déverrouiller le succès pour un utilisateur. Cela se faisait à l’aide d’une nouvelle section « Achievement Rules » dans la configuration d’un succès. Bien qu’une logique de déverrouillage dans le cloud puisse être puissante, cette exigence de configuration supplémentaire ajoute de la complexité à la conception et à la création des succès d’un titre.
  3. Le mécanisme de déverrouillage basé sur le cloud est difficile à dépanner. Bien que le service Achievements basé sur les événements introduise des fonctionnalités utiles, il peut aussi être plus difficile pour les développeurs de jeux de valider et de dépanner les problèmes liés à leurs succès. En effet, les déverrouillages de succès sont déclenchés indirectement par des règles qui résident sur le service au lieu d’être contrôlés directement par le jeu lui-même.
Les développeurs de jeux ont également indiqué qu’ils apprécient certaines des fonctionnalités introduites par les succès basés sur les événements, telles que les suivantes :
  1. Des fonctionnalités d’expérience utilisateur comme la progression des succès, les mises à jour en temps réel, les récompenses sous forme d’illustrations conceptuelles et la publication des déverrouillages dans un flux d’activité.
  2. Des améliorations de configuration, comme une configuration de service au lieu d’une configuration locale devant être incluse dans le package du jeu (par exemple gameconfig, XLAST et SPA).
  3. La possibilité de modifier facilement les chaînes et les images des succès après la sortie du jeu.
Les succès gérés par le titre remplacent le service Achievements basé sur les événements : ils facilitent encore davantage la configuration des succès, l’intégration des déverrouillages et des mises à jour dans le code du jeu, et la vérification du bon fonctionnement des succès.

Ce qui change avec les succès gérés par le titre

Exigences relatives aux titres

Voici les exigences applicables à tout titre qui utilisera le service Achievements géré par le titre.
  1. Ne doit pas avoir été publié avec les succès basés sur les événements. Les titres déjà publiés qui utilisent le service Achievements basé sur les événements ne sont pas éligibles. Pour plus d’informations, consultez Pourquoi les titres existants ne peuvent-ils pas « migrer » vers le service Achievements géré par le titre ?
  2. Doit utiliser le kit de développement logiciel XBOX One d’août 2016 ou une version ultérieure.
  3. Doit faire partie d’un programme de développeurs géré tel que ID@XBOX. Le service Achievements géré par le titre n’est pas disponible pour le Creators Program ni pour les plateformes héritées, notamment XBOX 360, Windows 8.x ou version antérieure, ou Windows Phone 8 ou version antérieure.

Questions fréquentes

Si mon titre utilise les statistiques basées sur les événements, dois-je également utiliser les succès basés sur les événements ?

Non. Nous vous recommandons d’utiliser les succès gérés par le titre conjointement avec les statistiques basées sur les événements.

Pourquoi les défis ne sont-ils pas pris en charge dans le service Achievements géré par le titre ?

Les données d’utilisation des jeux XBOX ont montré que l’implémentation et la présentation actuelles des défis ne répondent pas à un besoin de la plupart des développeurs de jeux. Nous continuerons à recueillir l’avis et les commentaires des développeurs afin de proposer de futures fonctionnalités adaptées à leurs besoins.

Puis-je toujours ajouter de nouveaux succès avec des mises à jour de contenu si mon titre utilise le service Achievements géré par le titre ?

Oui. La stratégie relative aux succès est la même pour tous les services. Pour plus d’informations, consultez XR-055 : Succès et Gamerscore.

Pourquoi les titres existants ne peuvent-ils pas « migrer » vers le service Achievements géré par le titre ?

Pour la grande majorité des titres existants, une « migration » vers le service Achievements géré par le titre exigerait bien plus que la mise à jour de leur configuration de service et le remplacement des écritures d’événements par des appels de déverrouillage de succès. Ces seules modifications seraient très coûteuses et comporteraient un risque important d’erreurs et de comportements inattendus pouvant endommager irrémédiablement les succès. De plus, la plupart des titres existants ont également des utilisateurs disposant de données existantes. Tenter de convertir un jeu en production qui utilise déjà le service Achievements basé sur les événements représenterait un effort très coûteux, tant pour le développeur que pour XBOX, et compromettrait considérablement les profils et les expériences de jeu des utilisateurs existants.

Si mon titre a été publié avec le service Achievements basé sur les événements, un futur contenu téléchargeable (DLC) pour ce titre peut-il passer aux succès gérés par le titre ?

Tous les succès d’un titre doivent utiliser le même service Achievements. Le service Achievements utilisé par le jeu de base doit être utilisé pour tous les futurs succès du titre.

Lorsque je teste des succès dans mon bac à sable de développement, puis-je combiner le service Achievements géré par le titre et le service Achievements basé sur les événements ?

Non. Tous les succès d’un titre doivent utiliser le même service Achievements.

Le service Achievements géré par le titre prend-il en charge les déverrouillages de succès hors connexion ?

Si le titre déverrouille un succès alors que l’appareil est hors connexion, l’API met automatiquement en file d’attente les demandes de déverrouillage hors connexion. Les demandes de déverrouillage se synchronisent automatiquement avec les services XBOX lorsque l’appareil rétablit la connectivité réseau, de manière similaire à l’expérience hors connexion du service Achievements basé sur les événements. Les déverrouillages de succès n’ont pas lieu tant que l’utilisateur est hors connexion.

Je vois un nouvel événement AchievementUpdate dans Partner Center. Si mon titre utilise cet événement, cela signifie-t-il qu’il utilise les succès gérés par le titre ?

L’événement de base AchievementUpdate est requis par les services XBOX à des fins internes. Vous pouvez ignorer cet événement de base en toute sécurité. Si votre titre configure un événement à l’aide de ce type d’événement de base, ces écritures d’événements sont ignorées par les services XBOX. Les titres reposant sur le service Achievements basé sur les événements doivent continuer à configurer leurs événements à l’aide des autres types d’événements de base. Les titres reposant sur le service Achievements géré par le titre n’ont besoin de configurer aucun événement pour les succès.

Comment réinitialiser les données de succès d’un utilisateur de test ?

Vous pouvez utiliser l’outil XblPlayerDataReset pour réinitialiser les données de joueur XBOX d’un utilisateur de test, y compris les succès. Consultez la documentation de XblPlayerDataReset pour savoir comment utiliser l’outil.
Dernière modification le 20 octobre 2026