XblLeaderboardQuery
Representa os parâmetros para enviar uma consulta de placar de líderes usando estatísticas baseadas em eventos ou baseadas no título.Sintaxe
Membros
xboxUserIdTipo: uint64_t ID de usuário do XBOX opcional do usuário solicitante. Se for um placar de líderes global, defina como 0. scid
Tipo: char[XBL_SCID_LENGTH] A ID de configuração de serviço (SCID) do título, codificada em UTF-8. leaderboardName
Tipo: const char* Nome opcional, codificado em UTF-8, do placar de líderes a ser obtido. Defina como nullptr ao consultar um placar de líderes social ou um placar de líderes baseado em estatísticas gerenciadas pelo título. statName
Tipo: const char* Nome opcional, codificado em UTF-8, da estatística para a qual obter um placar de líderes. Usado ao consultar um placar de líderes social ou um placar de líderes baseado em estatísticas gerenciadas pelo título. socialGroup
Tipo: XblSocialGroupType Opcional: o grupo social de usuários para o qual obter resultados do placar de líderes. Por exemplo, para obter um placar de líderes “somente amigos”. Defina como XblSocialGroupType_None para obter um placar de líderes global. additionalColumnleaderboardNames
Tipo: const char** Matriz opcional, codificada em UTF-8, de nomes de estatísticas para as colunas adicionais. additionalColumnleaderboardNamesCount
Tipo: size_t Contagem opcional de additionalColumnleaderboardNames passados. order
Tipo: XblLeaderboardSortOrder Define a ordem de classificação do placar de líderes resultante. maxItems
Tipo: uint32_t Define o número máximo de itens que o placar de líderes resultante contém. Defina como 0 para permitir que o serviço retorne o número máximo padrão de itens. skipToXboxUserId
Tipo: uint64_t Define em torno de qual usuário o placar de líderes resultante é centralizado. Defina como 0 para não pular para um usuário específico. skipResultToRank
Tipo: uint32_t Define em torno de qual classificação o placar de líderes resultante é centralizado. Defina como 0 para não pular para uma classificação específica. continuationToken
Tipo: const char* O continuationToken codificado em UTF-8 usado para obter o próximo conjunto de dados do placar de líderes. queryType
Tipo: XblLeaderboardQueryType O tipo de placar de líderes a ser consultado.
Membro de
XblLeaderboardResultArgumento de
XblLeaderboardGetLeaderboardAsyncComentários
Estatísticas baseadas em eventos
Ao usar o membro statName com estatísticas baseadas em eventos, o valor deve coincidir com uma instância de estatística.Estatísticas gerenciadas pelo título
Ao usar estatísticas gerenciadas pelo título para placares de líderes, definir skipToXboxUserId com um valor diferente de zero compara a estatística armazenada do xboxUserId fornecido com o placar de líderes global. Da mesma forma, definir socialGroup como People ou Favorites compara as estatísticas armazenadas do xboxUserId fornecido e dos usuários associados. Os valores do placar de líderes global não são usados. Observe que, quando a estatística armazenada de um jogador e sua pontuação no placar de líderes global não são iguais, isso pode gerar resultados incompatíveis.Para estatísticas gerenciadas pelo título, a entrada de um jogador no placar de líderes global não é uma projeção direta da estatística armazenada atual dele. O serviço de placar de líderes mantém apenas o maior valor registrado para cada jogador. Como resultado, gravar um valor menor em uma estatística não reduz a posição desse jogador no placar de líderes global; o placar de líderes continua refletindo o máximo registrado anteriormente. A própria estatística armazenada, que pode ser consultada por meio de
XblUserStatisticsGet* ou XblTitleManagedStatsGetForUserAsync, reflete o valor gravado mais recentemente, e é por isso que ela pode divergir do placar de líderes.Se o seu título precisar que as posições no placar de líderes diminuam, as estatísticas gerenciadas pelo título não são adequadas. Exemplos incluem uma classificação que sobe ou desce, ou uma pontuação que é redefinida em caso de derrotas. Em vez disso, considere estatísticas baseadas em eventos com uma regra Replace ou um serviço de placar de líderes externo, como o PlayFab Leaderboards v2. Para obter mais informações sobre esse comportamento, consulte as Notas de implementação do exemplo LeaderboardsTitleManaged do Microsoft Game Development Kit (GDK).Requisitos
Cabeçalho: leaderboard_c.hConfira também
leaderboard_cEstatísticas baseadas em eventos versus estatísticas gerenciadas pelo título