- Avant de commencer
- Obtenir la liste des succès
- Obtenir la page suivante des résultats de succès
- Obtenir un succès unique
Avant de commencer
- Votre produit utilise l’ensemble complet des fonctionnalités des services XBOX. Les nouveaux produits démarrent avec des services XBOX limités, et les succès et le gamerscore ne sont pas disponibles tant que votre produit n’a pas été intégré. Pour plus d’informations, consultez Demander l’intégration du produit pour activer l’ensemble des services XBOX.
- Vous avez configuré vos succès dans Partner Center et publié la configuration des services XBOX dans votre sandbox de développement. Pour plus d’informations, consultez Configurer les succès gérés par le titre dans Partner Center.
- Votre kit de développement ou votre PC Windows utilise la même sandbox de développement, et vous vous connectez avec un compte de test qui a accès à cette sandbox. Pour plus d’informations, consultez Vue d’ensemble des sandboxes des services XBOX.
- Votre jeu a initialisé Gaming Runtime, puis a appelé XblInitialize avec une structure XblInitArgs dont le membre
scidcontient votre ID de configuration de service (SCID). Le SCID respecte la casse. Pour plus d’informations, consultez Utilisation des API des services XBOX. - Vous avez connecté un utilisateur et créé un
XblContextHandlepour cet utilisateur en appelant XblContextCreateHandle.
Obtenir la liste des succès
Pour obtenir les succès du titre en cours d’exécution, appelez XblAchievementsGetAchievementsForTitleIdAsync, comme suit.Appel de XblAchievementsGetAchievementsForTitleIdAsync
C++- XAsyncBlock
- XblAchievement
- XblAchievementProgressState
- XblAchievementsGetAchievementsForTitleIdAsync
- XblAchievementsGetAchievementsForTitleIdResult
- XblAchievementsResultCloseHandle
- XblAchievementsResultDuplicateHandle
- XblAchievementsResultGetAchievements
Obtenir la page suivante des résultats de succès
Il peut y avoir d’autres pages de succès. Pour le vérifier, appelez XblAchievementsResultHasNext. Pour obtenir la page suivante, appelez XblAchievementsResultGetNextAsync avec le handle de résultat actuel, puis appelez XblAchievementsResultGetNextResult dans le rappel.XblAchievementsResultGetNextResult retourne un nouveau handle de résultat. Chaque handle de résultat doit être fermé séparément. Si vous passez 0 pour maxItems, la fonction tente de récupérer tous les éléments, mais le service peut appliquer une taille de page par défaut et retourner moins d’éléments que demandé, même s’il reste d’autres pages. Vérifiez toujours XblAchievementsResultHasNext au lieu de supposer qu’un seul appel retourne tous les succès.
Traitement de toutes les pages de résultats
Dans l’exemple suivant, au lieu de fermer le handle de résultat obtenu à partir deXblAchievementsGetAchievementsForTitleIdResult, passez-le à ProcessAchievementsPage. La fonction prend possession du handle que vous lui passez et ferme ce handle une seule fois. Le handle actuel reste ouvert jusqu’à la fin de la requête de la page suivante.
C++
- XAsyncBlock
- XblAchievement
- XblAchievementProgressState
- XblAchievementsResultCloseHandle
- XblAchievementsResultGetAchievements
- XblAchievementsResultGetNextAsync
- XblAchievementsResultGetNextResult
- XblAchievementsResultHasNext
Obtenir un succès unique
Pour obtenir un succès unique, appelez XblAchievementsGetAchievementAsync, comme suit. API C plate- XAsyncBlock
- XblAchievement
- XblAchievementsGetAchievementAsync
- XblAchievementsGetAchievementResult
- XblAchievementsResultCloseHandle
- XblAchievementsResultGetAchievements
