Pular para o conteúdo principal

Início rápido das tabelas de classificação

Neste guia, vamos ver como configurar o ambiente de desenvolvimento para o serviço Leaderboards. Também vamos aprender a criar rapidamente uma tabela de classificação no nosso site Game Manager.

Pré-requisitos

Vamos precisar de uma conta do PlayFab para usar o serviço de tabelas de classificação do PlayFab. Para obter instruções sobre como criar uma conta, confira Autenticação

Criando uma tabela de classificação

Vamos selecionar Progression no menu à esquerda. Menu principal das tabelas de classificação do PlayFab Agora selecionamos a guia Leaderboards no menu superior. Tabelas de classificação do PlayFab no Game Manager Em seguida, vamos clicar no botão “New Leaderboard” e criar nossa definição de tabela de classificação. Definição de tabela de classificação do PlayFab Aqui podemos configurar todos os aspectos da tabela de classificação. Saiba mais sobre os parâmetros disponíveis e como criar tabelas de classificação aqui: O resultado final deve ser parecido com este. Uso das tabelas de classificação do PlayFab

Configurando o ambiente

Aqui vamos aprender a configurar o ambiente de desenvolvimento para usar o SDK do C#, mas os conceitos apresentados aqui também funcionam com outros SDKs ou com solicitações HTTP simples.

Definindo o TitleId e a DeveloperSecretKey

A DeveloperSecretKey é necessária ao autenticar como entidade de título.

Criando um título e obtendo a chave secreta

  • Entre em https://developer.playfab.com/
  • Crie um título
    • Localize o Title ID na seção API Features, em configurações.
  • Gere uma chave secreta:
    • Engrenagem ao lado do nome do título, no canto superior esquerdo da exibição do título
    • Title Settings
    • Secret Keys
    • New secret key
Veja como é a interface do usuário ao localizar a seção Secret Key no Game Manager. Chaves das tabelas de classificação do PlayFab

Entrar como título

Para operações de gravação, recomendamos usar a TitleEntity a partir do servidor do seu jogo. Esse método retornará o AuthenticationContext que será usado em todas as solicitações que fizermos.

Entrar como jogador (criar jogador)

Esse método cria um jogador com base em um identificador, o que retorna uma entidade do tipo title_player_account. Mais informações aqui: Início rápido de entidades

Definir a propriedade de nome de exibição de uma entidade

Para que a propriedade DisplayName esteja disponível como parte da resposta das “APIs Get Leaderboards”, precisamos executar o código a seguir para cada entidade que criamos, a fim de mapear a entidade para o nome de exibição personalizado do jogo.

Confira também

Última modificação em 6 de outubro de 2026