XblLeaderboardQuery
Représente les paramètres permettant d’envoyer une requête de classement à l’aide de statistiques basées sur les événements ou sur le titre.Syntaxe
Membres
xboxUserIdType : uint64_t ID utilisateur XBOX facultatif de l’utilisateur demandeur. Pour un classement global, définissez-le sur 0. scid
Type : char[XBL_SCID_LENGTH] ID de configuration de service (SCID) du titre, encodé en UTF-8. leaderboardName
Type : const char* Nom facultatif, encodé en UTF-8, du classement à obtenir. Définissez-le sur nullptr si vous interrogez un classement social ou un classement reposant sur une statistique gérée par le titre. statName
Type : const char* Nom facultatif, encodé en UTF-8, de la statistique pour laquelle obtenir un classement. Utilisé lors de l’interrogation d’un classement social ou d’un classement reposant sur une statistique gérée par le titre. socialGroup
Type : XblSocialGroupType Facultatif. Groupe social d’utilisateurs pour lequel obtenir les résultats du classement, par exemple pour obtenir un classement « amis uniquement ». Définissez-le sur XblSocialGroupType_None pour obtenir un classement global. additionalColumnleaderboardNames
Type : const char** Tableau facultatif, encodé en UTF-8, des noms de statistiques pour les colonnes supplémentaires. additionalColumnleaderboardNamesCount
Type : size_t Nombre facultatif de additionalColumnleaderboardNames transmis. order
Type : XblLeaderboardSortOrder Définit l’ordre de tri du classement obtenu. maxItems
Type : uint32_t Définit le nombre maximal d’éléments que contient le classement obtenu. Définissez-le sur 0 pour laisser le service renvoyer le nombre maximal d’éléments par défaut. skipToXboxUserId
Type : uint64_t Définit l’utilisateur autour duquel le classement obtenu est centré. Définissez-le sur 0 pour ne pas passer à un utilisateur spécifique. skipResultToRank
Type : uint32_t Définit le rang autour duquel le classement obtenu est centré. Définissez-le sur 0 pour ne pas passer à un rang spécifique. continuationToken
Type : const char* continuationToken, encodé en UTF-8, utilisé pour obtenir le jeu suivant de données de classement. queryType
Type : XblLeaderboardQueryType Type de classement à interroger.
Membre de
XblLeaderboardResultArgument de
XblLeaderboardGetLeaderboardAsyncRemarques
Statistiques basées sur les événements
Lorsque vous utilisez le membre statName avec des statistiques basées sur les événements, la valeur doit correspondre à une instance de statistique.Statistiques gérées par le titre
Lorsque vous utilisez des statistiques gérées par le titre pour les classements, définir skipToXboxUserId sur une valeur non nulle compare la statistique stockée du xboxUserId donné au classement global. De même, définir socialGroup sur People ou Favorites compare les statistiques stockées du xboxUserId donné et des utilisateurs associés. Les valeurs du classement global ne sont pas utilisées. Notez que lorsque la statistique stockée d’un joueur et son score dans le classement global ne sont pas identiques, les résultats obtenus peuvent ne pas concorder.Pour les statistiques gérées par le titre, l’entrée d’un joueur dans le classement global n’est pas une projection directe de sa statistique stockée actuelle. Le service de classement conserve uniquement la valeur la plus élevée enregistrée pour chaque joueur. Par conséquent, écrire une valeur inférieure dans une statistique ne fait pas baisser la position de ce joueur dans le classement global ; le classement continue de refléter le maximum enregistré précédemment. La statistique stockée elle-même, interrogeable via
XblUserStatisticsGet* ou XblTitleManagedStatsGetForUserAsync, reflète la dernière valeur écrite, ce qui explique pourquoi elle peut différer du classement.Si votre titre a besoin que les positions dans le classement puissent baisser, les statistiques gérées par le titre ne conviennent pas. Par exemple, une évaluation qui peut augmenter ou diminuer, ou un score qui est réinitialisé en cas de défaite. Envisagez plutôt des statistiques basées sur les événements avec une règle Replace, ou un service de classement externe tel que PlayFab Leaderboards v2. Pour plus d’informations sur ce comportement, consultez les notes d’implémentation de l’exemple LeaderboardsTitleManaged du Microsoft Game Development Kit (GDK).Configuration requise
En-tête : leaderboard_c.hVoir aussi
leaderboard_cStatistiques basées sur les événements et statistiques gérées par le titre