Pular para o conteúdo principal

Início rápido de torneios e placares

Este início rápido descreve como ter uma estatística que acompanha a pontuação mais alta dos jogadores e como obter um placar das melhores pontuações. Isso pode ser utilizado para um placar global ou em conjunto com estatísticas redefiníveis para redefinir em um evento ou torneio específico.

Pré-requisitos

Seu jogador já está conectado ao PlayFab.

Etapa 1 - Criar uma estatística e o placar associado

No Game Manager:
  • Acesse Leaderboards no menu à esquerda.
  • Selecione NEW LEADERBOARD.
  • Adicione um Leaderboard chamado HighScore no campo Statistic name.
  • Usando o menu suspenso fornecido, defina o campo Reset frequency como Manually.
  • Vá para o campo Aggregation method e selecione Maximum (sempre usar o valor mais alto) no menu suspenso fornecido.

Etapa 2 - Atualizar a estatística com a pontuação mais alta de um jogador

Antes de podermos usar UpdatePlayerStatistics do cliente, precisamos habilitá-la em API Features.
  1. Selecione Title settings no menu Settings do seu título.
  2. Selecione a guia API Features.
  3. Marque a caixa Allow client to post player statistics. OBSERVAÇÃO: em geral, essa opção não deve ser usada em um jogo em produção, pois dá ao cliente autoridade sobre os valores enviados. Isso só é válido para casos em que não há preocupação de que os jogadores trapaceiem em suas estatísticas. Se as estatísticas precisarem ser seguras, elas só devem ser atualizadas por meio de uma operação com autoridade do servidor, como um Cloud Script ou um servidor de jogo personalizado.
  4. Selecione SAVE na parte inferior da tela.
Game Manager - Settings - API Features - Allow client to post player statistics

Exemplo de código C# - SubmitScore

Neste exemplo de código, teremos uma função SubmitScore que seria chamada no final de uma partida.

Etapa 3 - Solicitar o placar da pontuação mais alta

Para obter o placar das melhores pontuações de todos os jogadores que jogaram o jogo, você fará uma chamada para GetLeaderboard.

Exemplo de código C# - RequestLeaderboard

Neste exemplo de código, teremos uma função RequestLeaderboard que seria chamada para obter o placar e passará os resultados para uma função DisplayLeaderboard, que preencheria a experiência no seu jogo que mostra as pontuações mais altas.
Última modificação em 6 de outubro de 2026