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

# Démarrage rapide des classements

> Démarrage rapide pour PlayFab Leaderboards : créez votre premier classement dans Game Manager et configurez le SDK C# avec votre TitleId et votre clé secrète de développeur.

# Démarrage rapide des classements

Dans ce guide, nous allons voir comment configurer l'environnement de développement pour le service Leaderboards. Nous allons aussi
apprendre à créer rapidement un classement à partir de notre site Web [Game Manager](https://developer.playfab.com).

## Prérequis

Nous aurons besoin d'un compte PlayFab pour utiliser le service PlayFab Leaderboards. Pour obtenir des instructions sur la création d'un compte,
consultez [Authentification](/fr-CA/services/playfab/identity/player-identity/authentication)

## Création d'un classement

Nous allons sélectionner Progression dans le menu de gauche.

![Menu principal de PlayFab Leaderboards](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)

Nous sélectionnons maintenant l'onglet Leaderboards dans le menu supérieur.

![PlayFab Leaderboards dans Game Manager](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)

Ensuite, nous allons cliquer sur le bouton « New Leaderboard » et créer notre définition de classement.

![Définition de classement PlayFab Leaderboards](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)

Ici, nous pouvons configurer chaque aspect du classement. Pour en savoir plus sur les paramètres disponibles et
sur la création de classements, consultez :

* [Créer un classement de base](/fr-CA/services/playfab/community/leaderboards/create-basic-leaderboard).
* [Référence de l'API](/fr-CA/services/playfab/community/leaderboards/api-reference)

Le résultat final devrait ressembler à ceci.

![Utilisation de PlayFab Leaderboards](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)

## Configuration de l'environnement

Nous allons ici apprendre à configurer l'environnement de développement pour utiliser le SDK C#, mais les concepts
présentés ici fonctionnent aussi avec d'autres SDK ou de simples requêtes HTTP.

## Définition de TitleId et de DeveloperSecretKey

DeveloperSecretKey est nécessaire lors de l'authentification en tant qu'entité de titre.

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

## Création d'un titre et obtention de la clé secrète

* Connectez-vous à [https://developer.playfab.com/](https://developer.playfab.com/)
* Créez un titre
  * Repérez l'ID de titre dans la section API Features des paramètres.
* Générez une clé secrète :
  * Icône d'engrenage à côté du nom du titre, en haut à gauche de la vue du titre
  * Title Settings
  * Secret Keys
  * New secret key

Voici à quoi ressemble l'interface utilisateur lorsque vous trouvez la section Secret Keys dans Game Manager.

![Clés de PlayFab Leaderboards](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)

## Connexion en tant que titre

Pour les opérations d'écriture, nous recommandons d'utiliser TitleEntity à partir de votre serveur de jeu; cette méthode retournera l'`AuthenticationContext` qui
sera utilisé dans toutes les requêtes que nous effectuerons.

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

## Connexion en tant que joueur (créer un joueur)

Cette méthode crée un joueur à partir d'un identificateur et retourne une entité de type `title_player_account`. Plus d'informations ici :
[Démarrage rapide des entités](/fr-CA/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;
}
```

## Définir la propriété de nom d'affichage d'une entité

Pour que la propriété `DisplayName` soit disponible dans la réponse des « API Get Leaderboards »,
nous devons exécuter le code suivant pour chaque entité que nous avons créée afin d'associer l'entité au nom
d'affichage personnalisé du jeu.

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

## Voir aussi

* [Créer un classement de base](/fr-CA/services/playfab/community/leaderboards/create-basic-leaderboard).
* [Aller plus loin avec les classements](/fr-CA/services/playfab/community/leaderboards/doing-more-with-leaderboards).
* [Limites ](/fr-CA/services/playfab/community/leaderboards/limits-leaderboards).
* [Quota ](/fr-CA/services/playfab/community/leaderboards/quota-leaderboards).
* [Classements saisonniers](/fr-CA/services/playfab/community/leaderboards/seasonal-leaderboards).
* [Classements de groupe](/fr-CA/services/playfab/community/leaderboards/group-leaderboards).
* [Niveaux manuels](/fr-CA/services/playfab/community/leaderboards/manual-tiers).
* [Classer les joueurs selon les statistiques](/fr-CA/services/playfab/community/leaderboards/leaderboards-linked-to-stats).
* [Ajouter des données contextuelles aux classements](/fr-CA/services/playfab/community/leaderboards/metadata-leaderboards).
* [Référence de l'API](/fr-CA/services/playfab/community/leaderboards/api-reference).
* [Compteurs de classements](/fr-CA/services/playfab/pricing/meters/leaderboard-meters).
* [Classements et CloudScript](/fr-CA/services/playfab/community/leaderboards/leaderboards-cloudscript).
* [Classements avec PlayStream](/fr-CA/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry)


## Related topics

- [Vue d'ensemble de PlayFab Leaderboards](/fr-CA/services/playfab/community/leaderboards/index.md)
- [Démarrage rapide : tournois et classements](/fr-CA/services/playfab/community/leaderboards/tournaments-leaderboards/quickstart.md)
- [Démarrage rapide des statistiques](/fr-CA/services/playfab/player-progression/statistics/quickstart-statistics.md)
- [Démarrage rapide des notifications push](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart.md)
- [Démarrage rapide (Windows) - Appel des services PlayFab](/fr-CA/services/playfab/sdks/unified-sdk/quickstart-services.md)
