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

# Inicio rápido de tablas de clasificación

> Inicio rápido de las tablas de clasificación de PlayFab: cree su primera tabla de clasificación en Game Manager y configure el SDK de C# con su TitleId y la clave secreta de desarrollador.

# Inicio rápido de tablas de clasificación

En esta guía, vamos a ver cómo configurar el entorno de desarrollo para el servicio de tablas de clasificación. También vamos
a aprender a crear rápidamente una tabla de clasificación desde nuestro sitio web [Game Manager](https://developer.playfab.com).

## Requisitos previos

Vamos a necesitar una cuenta de PlayFab para usar el servicio de tablas de clasificación de PlayFab. Para obtener instrucciones sobre cómo crear una cuenta,
consulte [Autenticación](/services/playfab/identity/player-identity/authentication)

## Creación de una tabla de clasificación

Vamos a seleccionar Progression en el menú de la izquierda.

<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="Menú principal de tablas de clasificación de PlayFab" width="1200" height="940" data-path="images/playfab/community/leaderboards/game-manager-main-menu.png" />

Ahora seleccionamos la pestaña Leaderboards en el menú 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="Game Manager de tablas de clasificación de PlayFab" width="2282" height="1528" data-path="images/playfab/community/leaderboards/leaderboards-game-manager.png" />

Después, vamos al botón "New Leaderboard" y creamos nuestra definición de tabla de clasificación.

<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="Definición de tablas de clasificación de PlayFab" width="2074" height="1528" data-path="images/playfab/community/leaderboards/leaderboard-definition.png" />

Aquí podemos configurar todos los aspectos de la tabla de clasificación. Obtenga más información sobre los parámetros disponibles y
cómo crear tablas de clasificación aquí:

* [Creación de una tabla de clasificación básica](/services/playfab/community/leaderboards/create-basic-leaderboard).
* [Referencia de API](/services/playfab/community/leaderboards/api-reference)

El resultado final debería ser como 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 de tablas de clasificación de PlayFab" width="1280" height="900" data-path="images/playfab/community/leaderboards/leaderboard-menu.png" />

## Configuración del entorno

Aquí vamos a aprender a configurar el entorno de desarrollo para usar el SDK de C#, pero los conceptos
presentados aquí también pueden funcionar con otros SDK o con solicitudes HTTP simples.

## Establecimiento de TitleId y DeveloperSecretKey

DeveloperSecretKey es necesario al autenticarse como entidad 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
```

## Creación de un título y obtención de la clave secreta

* Inicie sesión en [https://developer.playfab.com/](https://developer.playfab.com/)
* Cree un título
  * Busque el Title ID en la sección API Features, en la configuración.
* Genere la clave secreta:
  * Engranaje junto al nombre del título en la parte superior izquierda de la vista del título
  * Title Settings
  * Secret Keys
  * New secret key

Así es como se ve la interfaz de usuario cuando encuentra la sección de claves secretas en 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="Claves de tablas de clasificación de PlayFab" width="1280" height="900" data-path="images/playfab/community/leaderboards/secret-keys.png" />

## Inicio de sesión como título

Para las operaciones de escritura, se recomienda usar TitleEntity desde el servidor del juego; este método va a devolver el `AuthenticationContext` que
se usará en todas las solicitudes que realicemos.

```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;
}
```

## Inicio de sesión como jugador (creación de un jugador)

Este método crea un jugador basado en un identificador, que devuelve una entidad de tipo `title_player_account`. Más información aquí:
[Inicio rápido de entidades](/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;
}
```

## Establecimiento de la propiedad de nombre para mostrar de una entidad

Para tener disponible la propiedad `DisplayName` como parte de la respuesta de las "Get Leaderboards APIs",
es necesario ejecutar el código siguiente por cada entidad que hayamos creado para asignar la entidad al nombre
para mostrar personalizado del juego.

```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);
}
```

## Consulte también

* [Creación de una tabla de clasificación básica](/services/playfab/community/leaderboards/create-basic-leaderboard).
* [Cómo hacer más con las tablas de clasificación](/services/playfab/community/leaderboards/doing-more-with-leaderboards).
* [Límites ](/services/playfab/community/leaderboards/limits-leaderboards).
* [Cuota ](/services/playfab/community/leaderboards/quota-leaderboards).
* [Tablas de clasificación de temporada](/services/playfab/community/leaderboards/seasonal-leaderboards).
* [Tablas de clasificación de grupos](/services/playfab/community/leaderboards/group-leaderboards).
* [Niveles manuales](/services/playfab/community/leaderboards/manual-tiers).
* [Clasificación de jugadores por estadísticas](/services/playfab/community/leaderboards/leaderboards-linked-to-stats).
* [Adición de datos contextuales a las tablas de clasificación](/services/playfab/community/leaderboards/metadata-leaderboards).
* [Referencia de API](/services/playfab/community/leaderboards/api-reference).
* [Medidores de tablas de clasificación](/services/playfab/pricing/meters/leaderboard-meters).
* [Tablas de clasificación y CloudScript](/services/playfab/community/leaderboards/leaderboards-cloudscript).
* [Tablas de clasificación con PlayStream](/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry)


## Related topics

- [Información general de PlayFab Leaderboards](/es/services/playfab/community/leaderboards/index.md)
- [Documentación de PlayFab Community](/es/services/playfab/community/index.md)
- [Creación de una tabla de clasificación básica](/es/services/playfab/community/leaderboards/create-basic-leaderboard.md)
- [Inicio rápido de torneos y tablas de clasificación](/es/services/playfab/community/leaderboards/tournaments-leaderboards/quickstart.md)
- [Inicio rápido de estadísticas](/es/services/playfab/player-progression/statistics/quickstart-statistics.md)
