Criando uma definição de placar de líderes com várias colunas
Para começar este exemplo, precisamos criar uma definição de placar de líderes mais complexa do que a que tínhamos antes. Vamos definir várias colunas para mapear os principais aspectos do jogo: eliminações, assistências e mortes. O exemplo a seguir mostra como criar a definição do placar de líderes usando o SDK do C#.SizeLimit: Este parâmetro é usado para limitar o número de linhas que o placar de líderes pode ter. O valor aqui é apenas um exemplo.VersionConfiguration: Este parâmetro nos permite ter controle de versão nos nossos placares de líderes. Consulte esta página para obter mais informações: Placares de líderes sazonaisColumns: Este parâmetro nos permite definir várias colunas, com no máximo 5 por definição. Como você pode ver, configuramos Eliminations, Assists e Deaths. Um elemento importante aqui é o parâmetroSortDirection, que nos permite determinar a classificação do placar de líderes. Neste exemplo, um jogador fica em uma posição mais alta se tiver mais eliminações e assistências (SortDirection = Descending) e menos mortes (SortDirection = Ascending).
Trazer entidades externas
O serviço de placares de líderes pode ser usado como um componente independente que oferece suporte para trazer entidades externas que só fazem sentido no contexto do jogo. Se as identidades dos seus jogadores não estiverem vinculadas ao logon do PlayFab, você ainda poderá usar o serviço de placares de líderes. O tipo de entidade para as entradas no placar de líderes fora do sistema do PlayFab deve ser external. O entityId é então a identidade do jogador no seu sistema. Nesses casos, todas as entradas no placar de líderes devem ser entidades external.Adicionando dados a um placar de líderes
Agora que criamos o nosso placar de líderes, vamos adicionar dados. A principal diferença em relação ao nosso tutorial anterior sobre este assunto é que agora precisamos adicionar três pontuações diferentes na mesma linha. O exemplo a seguir mostra como adicionar dados ao nosso placar de líderes usando o SDK do C#.Recuperando dados de um placar de líderes
Agora vamos aprender diferentes maneiras de consultar um placar de líderes. Todas elas têm um propósito específico, com a intenção de ajudar os desenvolvedores a obter os jogadores de que precisam para exibir no jogo.Obtendo o placar de líderes em torno de uma entidade
Essa forma específica de consultar o placar de líderes nos permite obter uma seção do placar de líderes próxima a uma entidade específica. Uma maneira prática de ver esse cenário é quando temos um placar de líderes enorme e queremos mostrar apenas informações relevantes ao jogador que está ativo no jogo. Se o jogador estiver na posição 1000, podemos mostrar os vizinhos próximos em vez dos melhores jogadores. O exemplo a seguir mostra como consultar um placar de líderes em torno de uma entidade usando o SDK do C#.MaxSurroundingEntries, que nos permite extrair do placar de líderes as entidades classificadas em torno de uma entidade específica.
Por exemplo, se tivermos um jogador na posição 100 e usarmos
MaxSurroundingEntries = 20, ele recuperará os jogadores da posição 90 à 110. Se o jogador estiver no topo
do placar de líderes, ele recuperará os 20 primeiros resultados. Se o jogador estiver na parte inferior, ele recuperará os 20 últimos resultados. Exceto pelas posições no topo e na parte inferior do placar de líderes, a API tenta garantir que a entidade em torno da qual a classificação é solicitada fique no centro das posições recuperadas.
Obtendo o placar de líderes para entidades
Esta API nos oferece outra maneira de consultar o placar de líderes. Ela funciona sempre que temos um caso em que queremos pesquisar várias entidades dentro do placar de líderes e classificá-las. O exemplo a seguir mostra como consultar um placar de líderes para uma lista de entidades usando o SDK do C#.Obtendo placares de líderes de amigos
Pode haver casos em que alguns jogadores casuais aparecem e jogam um jogo. Eles podem estar longe do topo do placar de líderes, mas, entre seus amigos, há uma competição acontecendo. Com esta API, podemos consultar o placar de líderes e encontrar os amigos do jogador.Desempate aprimorado
Considerando o nosso exemplo de um jogo de tiro altamente competitivo, há casos em que vários jogadores podem ter o mesmo número de eliminações. Para esses cenários, precisamos de uma maneira diferente de desempatar. É nesse cenário que a funcionalidade de desempate aprimorado entra em ação. Ao criar uma definição de placar de líderes, você pode ter várias colunas. A forma como você as adiciona determina como vamos classificar e desempatar alguns cenários. Há uma ordem de precedência, na qual a primeira coluna adicionada é a mais importante, depois a segunda, e assim por diante. No nosso exemplo, isso significa que, sempre que houver um empate em eliminações, o segundo critério será o número de assistências, e o critério final serão as mortes. No caso extremo de o empate ainda persistir, o padrão passa a ser o carimbo de data/hora: quem alcançou as pontuações primeiro. | Classificação | ID da entidade | Eliminações| Assistências | Mortes | LastUpdated|----------------------|------------------------------------|-------------------|-------------------------- |1 | “player 3” | 103 |24 | 15|“2024-08-27T20:24:36.738Z” |2 | “player 2” | 102 | 30| 20 |“2024-08-27T20:24:29.251Z” |3 | “player 1” | 100 | 25 |18 |“2024-08-27T19:52:26.642Z”
|4 | “player 4” | 100 | 25 | 18 |“2024-08-27T20:24:44.552Z” |4 | “player 5” | 100 | 25 | 19 |“2024-08-27T20:25:47.552Z” Neste exemplo, temos um empate entre três jogadores:
- “player 5”: Apesar de ter a mesma quantidade de eliminações e assistências, ele tem mais mortes, o que significa que fica na parte inferior do placar de líderes.
- “player 4”: Este jogador tem menos mortes que “player 5” e a mesma quantidade que “player 1”, mas player 1 alcançou esses números primeiro.
- “player 1”: Apesar de ter os mesmos números que “player 4”, este jogador foi o primeiro a alcançar essa pontuação no jogo, portanto fica em uma posição mais alta neste cenário de desempate.
Conclusões
Neste tutorial, aprendemos a realizar as seguintes operações:- Criar um placar de líderes com várias colunas.
- Conferir as várias maneiras de consulta.
- Entender o mecanismo de desempate aprimorado.
Consulte também
- Criar um placar de líderes básico.
- Placares de líderes sazonais.
- Limites .
- Cota .
- Classificando jogadores por estatísticas.
- Placares de líderes de grupo.
- Níveis manuais.
- Adicionar dados extras aos placares de líderes.
- Referência de API.
- Placares de líderes e CloudScript.
- Placares de líderes com PlayStream
