> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Início rápido das tabelas de classificação do PlayFab: crie sua primeira tabela de classificação no Game Manager e configure o SDK do C# com seu TitleId e sua chave secreta de desenvolvedor.

# 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](https://developer.playfab.com).

## 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](/pt-BR/services/playfab/identity/player-identity/authentication)

## Criando uma tabela de classificação

Vamos selecionar Progression no menu à esquerda.

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/game-manager-main-menu.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=ed7c9cadb094234b43bfc6cc7fa5ac26" alt="Menu principal das tabelas de classificação do PlayFab" width="1200" height="940" data-path="images/playfab/community/leaderboards/game-manager-main-menu.png" />

Agora selecionamos a guia Leaderboards no menu superior.

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/leaderboards-game-manager.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=7b4805585c64e031676a642f7d9ea99e" alt="Tabelas de classificação do PlayFab no Game Manager" width="2282" height="1528" data-path="images/playfab/community/leaderboards/leaderboards-game-manager.png" />

Em seguida, vamos clicar no botão "New Leaderboard" e criar nossa definição de tabela de classificação.

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/leaderboard-definition.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=e91f750f9d4dedcf3639d236c91ad0c4" alt="Definição de tabela de classificação do PlayFab" width="2074" height="1528" data-path="images/playfab/community/leaderboards/leaderboard-definition.png" />

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:

* [Criar uma tabela de classificação básica](/pt-BR/services/playfab/community/leaderboards/create-basic-leaderboard).
* [Referência da API](/pt-BR/services/playfab/community/leaderboards/api-reference)

O resultado final deve ser parecido com este.

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/leaderboard-menu.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=4330a9b1cf43c651dddcc63730517f40" alt="Uso das tabelas de classificação do PlayFab" width="1280" height="900" data-path="images/playfab/community/leaderboards/leaderboard-menu.png" />

## 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.

```C# theme={null}
PlayFabSettings.staticSettings.TitleId = ""; // Change this value to your own titleId from PlayFab Game Manager
PlayFabSettings.staticSettings.DeveloperSecretKey = ""; // Change this to your title's secret key from Game Manager
```

## Criando um título e obtendo a chave secreta

* Entre em [https://developer.playfab.com/](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.

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/secret-keys.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=bf4c2dbebc795a0fd49915fb5b64a067" alt="Chaves das tabelas de classificação do PlayFab" width="1280" height="900" data-path="images/playfab/community/leaderboards/secret-keys.png" />

## 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.

```C# theme={null}
public static async Task<PlayFabAuthenticationContext> LoginAsTitleEntity()
{
    GetEntityTokenRequest request = new GetEntityTokenRequest()
    {
        Entity = new PlayFab.AuthenticationModels.EntityKey()
        {
            Id = PlayFabSettings.staticSettings.TitleId,
            Type = "title",
        },                
    };

    PlayFabResult<GetEntityTokenResponse> entityTokenResult = await PlayFabAuthenticationAPI.GetEntityTokenAsync(request);

    PlayFabAuthenticationContext authContext = new PlayFabAuthenticationContext
    {
        EntityToken = entityTokenResult.Result.EntityToken
    };
    
    return authContext;
}
```

## 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](/pt-BR/services/playfab/live-service-management/game-configuration/entities/quickstart)

```C# theme={null}
private static async Task<PlayFabAuthenticationContext> LoginAsPlayer(string customId = "GettingStartedGuide")
{
    LoginWithCustomIDRequest request = new LoginWithCustomIDRequest { CustomId = customId, CreateAccount = true };

    PlayFabResult<LoginResult> loginResult = await PlayFabClientAPI.LoginWithCustomIDAsync(request);

    return loginResult.Result.AuthenticationContext;
}
```

## 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.

```C# theme={null}
private static async Task UpdateEntityDisplayName(PlayFabAuthenticationContext context, string customId)
{
    SetDisplayNameRequest request = new SetDisplayNameRequest()
    {
        AuthenticationContext = context,
        DisplayName = customId,
        Entity = new PlayFab.ProfilesModels.EntityKey()
        {
            Id = context.EntityId,
            Type = context.EntityType,
        },
    };

    PlayFabResult<SetDisplayNameResponse> updateNameResult = await PlayFabProfilesAPI.SetDisplayNameAsync(request);
}
```

## Confira também

* [Criar uma tabela de classificação básica](/pt-BR/services/playfab/community/leaderboards/create-basic-leaderboard).
* [Fazendo mais com tabelas de classificação](/pt-BR/services/playfab/community/leaderboards/doing-more-with-leaderboards).
* [Limites ](/pt-BR/services/playfab/community/leaderboards/limits-leaderboards).
* [Cota ](/pt-BR/services/playfab/community/leaderboards/quota-leaderboards).
* [Tabelas de classificação sazonais](/pt-BR/services/playfab/community/leaderboards/seasonal-leaderboards).
* [Tabelas de classificação de grupos](/pt-BR/services/playfab/community/leaderboards/group-leaderboards).
* [Níveis manuais](/pt-BR/services/playfab/community/leaderboards/manual-tiers).
* [Classificando jogadores por estatísticas](/pt-BR/services/playfab/community/leaderboards/leaderboards-linked-to-stats).
* [Adicionar dados contextuais às tabelas de classificação](/pt-BR/services/playfab/community/leaderboards/metadata-leaderboards).
* [Referência da API](/pt-BR/services/playfab/community/leaderboards/api-reference).
* [Medidores de tabelas de classificação](/pt-BR/services/playfab/pricing/meters/leaderboard-meters).
* [Tabelas de classificação e CloudScript](/pt-BR/services/playfab/community/leaderboards/leaderboards-cloudscript).
* [Tabelas de classificação com PlayStream](/pt-BR/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry)


## Related topics

- [Visão geral das tabelas de classificação do PlayFab](/pt-BR/services/playfab/community/leaderboards/index.md)
- [Cota das tabelas de classificação](/pt-BR/services/playfab/community/leaderboards/quota-leaderboards.md)
- [Limites das tabelas de classificação](/pt-BR/services/playfab/community/leaderboards/limits-leaderboards.md)
- [Início rápido das chaves de telemetria](/pt-BR/services/playfab/data-analytics/ingest-data/telemetry-keys-qs.md)
- [Início rápido das Conexões de Dados](/pt-BR/services/playfab/data-analytics/export-data/data-connection-quickstart.md)
