XblLeaderboardQuery
Représente les paramètres pour soumettre une requête de classement à l’aide de statistiques basées sur les événements ou sur le titre.Syntaxe
Membres
xboxUserIdType : uint64_t Identifiant d’utilisateur XBOX facultatif de l’utilisateur demandeur. S’il s’agit d’un classement global, définissez-le sur 0. scid
Type : char[XBL_SCID_LENGTH] Identifiant de configuration de service (SCID), encodé en UTF-8, du titre. leaderboardName
Type : const char* Nom de classement facultatif, encodé en UTF-8, pour lequel obtenir un classement. Définissez-le sur nullptr si vous interrogez un classement social ou un classement reposant sur des statistiques gérées par le titre. statName
Type : const char* Nom de statistique facultatif, encodé en UTF-8, pour lequel obtenir un classement. Utilisé lors de l’interrogation d’un classement social ou d’un classement reposant sur des statistiques gérées par le titre. socialGroup
Type : XblSocialGroupType Facultatif : groupe social d’utilisateurs pour lequel obtenir les résultats de classement. Par exemple, pour obtenir un classement « amis seulement ». 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 d’éléments 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 retourner 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 précis. 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 précis. continuationToken
Type : const char* continuationToken, encodé en UTF-8, utilisé pour obtenir le prochain ensemble 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 les 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 les 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 pointage au classement global ne sont pas identiques, cela peut produire des résultats incohérents.Pour les statistiques gérées par le titre, l’entrée d’un joueur au 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, l’écriture d’une valeur inférieure dans une statistique ne fait pas baisser la position de ce joueur au classement global; le classement continue de refléter le sommet précédemment enregistré. La statistique stockée elle-même, que l’on peut interroger au moyen de
XblUserStatisticsGet* ou de XblTitleManagedStatsGetForUserAsync, reflète la valeur écrite le plus récemment, ce qui explique pourquoi elle peut différer du classement.Si votre titre a besoin que les positions au classement puissent diminuer, les statistiques gérées par le titre ne conviennent pas. Par exemple, une cote qui monte ou descend, ou un pointage qui est réinitialisé en cas de défaite. Envisagez plutôt les statistiques basées sur les événements avec une règle Replace, ou un service de classement externe comme PlayFab Leaderboards v2. Pour en savoir plus 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