Leaderboards globais vs. sociais
Leaderboards globais
- Um leaderboard global classifica toda a base de usuários do XBOX e deve ser configurado.
- Um leaderboard global é uma exibição predefinida que você configura no serviço no momento da ingestão (antes ou a qualquer momento depois do lançamento do título).
Leaderboards sociais
- Um leaderboard social é gerado dinamicamente e classifica os amigos do jogador.
- Um leaderboard social inclui somente jogadores que estão no grafo social do jogador.
- Um leaderboard social não precisa ser predefinido no momento da ingestão, porque o serviço gera o leaderboard dinamicamente em tempo de execução, com base nas estatísticas de usuário existentes.
Entendendo os leaderboards
Os leaderboards têm dois componentes principais.- Um valor pelo qual classificar (nos serviços XBOX, é sempre uma instância de estatística do jogador).
- Ordem de classificação (valores maiores ou menores são melhores).
Estatísticas como valores de classificação
Os leaderboards são derivados de estatísticas de jogador. É fundamental ter as regras de estatística certas definidas para o que você precisa. Ao projetar seu jogo, tenha em mente em quais leaderboards você gostaria que seus jogadores fossem classificados.Leaderboards globais
Os leaderboards globais acompanham as melhores pontuações registradas pelos jogadores em toda a comunidade XBOX. A principal diferença dos leaderboards globais é que eles são predefinidos no momento da ingestão, especificando um nome de identificação do leaderboard, a estatística classificada e a ordem de classificação (crescente ou decrescente). Os títulos podem definir um número ilimitado de leaderboards globais e adicionar mais leaderboards a qualquer momento por meio da configuração de serviço. O número máximo de registros por leaderboard global está atualmente limitado a 10.000 entradas. Isso significa que, para jogadores cuja “melhor” pontuação não esteja entre as 10.000 primeiras, a pontuação não aparece no leaderboard. É possível ler uma “página” de até 100 entradas de leaderboard (XUID do jogador, gamertag, posição global e pontuação) por vez e especificar a posição inicial da página, ou recuperar entradas de leaderboard centralizadas em torno de uma gamertag especificada. Os resultados sempre abrangem todo o período; exibições por dia, semana e mês ainda não têm suporte. Os leaderboards globais podem ser acessados por meio da XBOX Services API (XSAPI) ou da nossa API REST usandoGET (/scids/{scid}/leaderboards/{leaderboardname}).
Veja uma captura de tela de como um leaderboard de exemplo poderia ser configurado para um jogo de corrida.
Leaderboards sociais
Os leaderboards sociais são ótimos incentivos para que os jogadores casuais se comparem e se classifiquem em relação aos amigos. Mesmo que não estejam nas posições mais altas da comunidade, eles ainda podem se sentir motivados a vencer jogadores que conhecem. Os leaderboards sociais são criados dinamicamente com base em qualquer estatística de usuário existente. Por isso, eles não precisam ser predefinidos no momento da ingestão e contêm somente os jogadores do grafo social de um jogador específico. A principal vantagem dos leaderboards sociais é que eles não são predefinidos. Você pode criar um leaderboard social para qualquer estatística do seu jogo. O chamador pode especificar duas coisas ao solicitar um leaderboard social: a instância de estatística e a ordem de classificação (o padrão é decrescente por classificação). Os resultados sempre abrangem todo o período; exibições por dia, semana e mês não têm suporte. Assim como nos leaderboards globais, um chamador pode ler uma “página” de até 100 entradas de leaderboard (XUID do jogador, gamertag, posição global e pontuação) por vez e especificar a posição inicial da página. Os leaderboards sociais são acessados por meio da XSAPI ou da nossa API REST usandoGET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite}).
Leaderboards globais com exibição social
Como os leaderboards sociais são criados dinamicamente, recuperar um leaderboard social leva mais tempo do que recuperar um leaderboard global. Para cenários em que seu título recupera com frequência um leaderboard social com base em um conjunto comum de critérios, você pode criar um leaderboard global e recuperar somente as entradas do leaderboard que pertencem ao grafo social do jogador. Isso resulta em um tempo de recuperação mais rápido do que o dos leaderboards sociais, porque o leaderboard já existe nos servidores dos serviços XBOX. Também resulta em um payload menor, porque os resultados se limitam ao grafo social do usuário. Esse tipo de leaderboard é um leaderboard global. Portanto, ele deve ser definido na configuração de serviço do título. Os leaderboards globais com exibição social são acessados usando a solicitação normal de leaderboard global,GET (/scids/{scid}/leaderboards/{leaderboardname}), e acrescentando a seguinte consulta à URL: &viewTarget=people&view=people.
Para dar suporte a exibições de leaderboard com várias colunas, é possível usar metadados de estatísticas. Um título pode definir campos de metadados para uma estatística de leaderboard, que podem ser retornados ao consultar as posições do leaderboard. Um título não deve usar o URI de estatísticas de usuário em lote para obter o mesmo comportamento, porque as configurações de privacidade podem impedir o acesso às estatísticas.
Leaderboards com várias colunas
Haverá casos em que você precisará de mais colunas em um leaderboard para dar mais informações à estatística. Por exemplo, em um leaderboard de mais inimigos derrotados, talvez você queira adicionar a arma que o jogador usou, o mapa onde aconteceu, o tipo de inimigo mais derrotado e a proporção de abates/mortes. Os leaderboards do XBOX têm suporte interno a várias colunas. Você pode obter facilmente esses tipos de classificação. O único pré-requisito é que a estatística usada para o leaderboard tenha um contexto de estatística definido. É ele que será usado como metadados adicionais. Por exemplo, para uma estatística FastestLap, talvez você queira configurar estas propriedades adicionais como contexto de estatística. Veja uma captura de tela de como elas poderiam ficar.
Atualmente, os leaderboards com várias colunas têm suporte em leaderboards globais e em leaderboards globais com exibição social. No entanto, se você quiser criar um leaderboard social com várias colunas, pode usar a chamada de estatísticas de usuário em lote para obter todas as estatísticas com seu contexto e, em seguida, criar o leaderboard manualmente.
Os leaderboards com várias colunas só são acessados por meio da nossa API REST usando a solicitação normal de leaderboard global,
GET (/scids/{scid}/leaderboards/{leaderboardname}), e acrescentando a seguinte consulta à URL: &include=valuemetadata.
Onde aparecem os leaderboards com estatísticas em destaque
Os leaderboards comparam os jogadores mostrando estatísticas selecionadas de um jogo. Os leaderboards são uma ótima forma de incentivar a competição entre seus jogadores. Eles mantêm os jogadores engajados em tentar superar sua melhor pontuação anterior e as pontuações dos amigos.- Os leaderboards de estatísticas em destaque são sempre exibidos no clube oficial de um título.
- Os leaderboards de estatísticas em destaque às vezes são exibidos em outras experiências XBOX, como a exibição de conquistas de um jogador no perfil dele.
- Você também pode usar as estatísticas em destaque configuradas para criar leaderboards dentro do seu título.