> ## 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 données de titre

> Lisez et écrivez des paires clé-valeur de données de titre PlayFab depuis les clients et serveurs de jeu à l'aide des API GetTitleData et SetTitleData, avec des exemples de code C#.

Les données de titre sont un ensemble de paires clé-valeur en texte brut, utilisées pour stocker et gérer à distance, sur le serveur, les données de configuration du jeu. Elles permettent de garder accessibles et organisées les variables de configuration à l'échelle du titre, qui peuvent être récupérées côté client.

Ce démarrage rapide explique comment créer et utiliser des données de titre par programmation.

Il s'agit d'un sujet important, car le stockage des données de configuration d'un jeu à distance sur le serveur, où elles peuvent être modifiées à tout moment, est l'une des raisons les plus fondamentales d'utiliser un service comme PlayFab.

## Obtention des données de titre

### Depuis le client de jeu

Utilisez [GetTitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata) de `PlayFabClientAPI` pour obtenir les KVP d'un titre précis. L'exemple de code suivant affiche les valeurs de toutes les données de titre.

```csharp theme={null}
public void ClientGetTitleData() {
    PlayFabClientAPI.GetTitleData(new GetTitleDataRequest(),
        result => {
            if(result.Data == null || !result.Data.ContainsKey("MonsterName")) Debug.Log("No MonsterName");
            else Debug.Log("MonsterName: "+result.Data["MonsterName"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}
```

### Depuis le serveur de jeu

Utilisez [GetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitledata) de `PlayFabServerAPI` pour obtenir les KVP d'un titre précis. L'exemple de code suivant affiche les valeurs de toutes les données de titre.

```csharp theme={null}
public void ServerGetTitleData() {
    PlayFabServerAPI.GetTitleData( new GetTitleDataRequest(),
        result => {
            if (result.Data == null || !result.Data.ContainsKey("MonsterName")) Debug.Log("No MonsterName");
            else Debug.Log("MonsterName: " + result.Data["MonsterName"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        });
}
```

## Définition des données de titre

Il est peu probable que les données de titre changent très fréquemment. Dans la plupart des cas, vous devez utiliser vos données de titre pour des données statiques qui restent pratiquement inchangées pendant toute la durée de vie du titre.

Vous pouvez définir les données de titre à l'aide de Game Manager ou d'une fonction de l'API serveur.

### Définition des données de titre à l'aide de Game Manager

Pour ajouter des données de titre principales à un titre à l'aide de Game Manager, procédez comme suit.

1. Ouvrez le titre dans **Game Manager**.
2. Sélectionnez **Content**, puis **Title Data**.
3. Sélectionnez **New Title Data**
4. Dans la page des nouvelles données de titre, entrez une valeur pour **Key** et une valeur pour **Value**. **Key** et **Value** sont tous deux stockés sous forme de chaînes.
5. Utilisez le bouton **Save** pour enregistrer le nouvel élément de données.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-new-title-data.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=2aad92647840e49665b006d43d2b6128" alt="La capture d'écran montre de nouvelles données de titre." width="2965" height="1053" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-new-title-data.PNG" />

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-add-primary-title-data.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=e4d36dac8aaf57c54f680f7bae73be7e" alt="Capture d'écran des données de titre" width="3000" height="1001" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-add-primary-title-data.PNG" />

### Définition des données de titre en appelant l'API serveur en C

L'API [SetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.settitledata) est une API serveur que vous devez appeler depuis un serveur dédié. Vous ne pouvez définir qu'une seule KVP de données de titre par appel à `SetTitleData`.

```csharp theme={null}
public void SetTitleData() {
    PlayFabServerAPI.SetTitleData(
        new SetTitleDataRequest {
            Key = "MonsterName",
            Value = "Dorf"
        },
        result => Debug.Log("Set titleData successful"),
        error => {
            Debug.Log("Got error setting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}
```

### Définition des remplacements de données de titre à l'aide de Game Manager

Un remplacement est également un ensemble de paires clé-valeur JSON, idéalement destiné à contenir les modifications différentielles requises dans les paires clé-valeur des données de titre principales. Par rapport aux données de titre principales, ces modifications différentielles peuvent comprendre de nouvelles paires clé-valeur, la modification de la valeur d'une clé existante ou la suppression d'une clé (avec NULL comme valeur).

Pour ajouter des remplacements aux données de titre principales, procédez comme suit.

1. Ouvrez le titre dans **Game Manager**.
2. Sélectionnez **Content**, puis **Title Data**.
3. Sélectionnez **New Override**.
4. Entrez l'Override Label, puis entrez une valeur pour **Key** et une valeur pour **Value**. Key et Value sont tous deux stockés sous forme de chaînes.
5. Utilisez le bouton **Save** pour enregistrer le nouveau remplacement des données de titre.

<Note>
  Pour l'instant, cet ensemble de paires clé/valeur de remplacement ne prend effet qu'avec [Experiments](/fr-CA/services/playfab/live-service-management/game-configuration/experiments).
</Note>

Si le joueur appartient à une variante d'expérience contenant des remplacements de données de titre, ceux-ci sont appliqués automatiquement côté serveur et retournés avec les données de titre côté client.

<Note>
  L'actualisation et la conservation des valeurs de remplacement des données de titre peuvent prendre jusqu'à une minute.
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/new-title-data-override.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=d0bf7381eb30bee016b63b5b8ae57eb0" alt="La capture d'écran montre un nouveau remplacement de données de titre." width="2955" height="1006" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/new-title-data-override.PNG" />

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/set-title-data-override.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=a4f1978c4749d06b4767a0cfaf64bbd5" alt="La capture d'écran montre comment définir un nouveau remplacement de données de titre." width="2999" height="974" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/set-title-data-override.PNG" />

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-landing.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=2655a7e1a34589e3c6f19590262d3426" alt="La capture d'écran montre les données de titre et le remplacement." width="2969" height="1572" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-landing.PNG" />

## Données de titre internes

Comme les données utilisateur, les données de titre disposent d'un stockage interne masqué pour le client. Ces données peuvent également être définies dans Game Manager ou au moyen d'une API serveur.

### Obtention des données de titre internes en appelant l'API serveur en C \#

```csharp theme={null}
public void GetTitleInternalData()
{
    PlayFabServerAPI.GetTitleInternalData( new GetTitleDataRequest(),
        result => {
            if (result.Data == null || !result.Data.ContainsKey("PlayFab")) Debug.Log("No PlayFab");
            else Debug.Log("PlayFab: " + result.Data["PlayFab"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}
```

### Définition des données de titre internes en appelant l'API serveur en C \#

```csharp theme={null}
public void SetTitleInternalData() {
    PlayFabServerAPI.SetTitleInternalData(
        new SetTitleDataRequest {
            Key = "PlayFab",
            Value = "{ \"Status\": \"Secretly Awesome\" }"
        },
        result => { Debug.Log("Set titleData successful"); },
        error =>
        {
            Debug.Log("Got error setting titleData:");
            Debug.Log(error.GenerateErrorReport());
        });
}
```

## Voir aussi

* [Utilisation des données d'éditeur](/fr-CA/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data)
* [Démarrage rapide des données de joueur](/fr-CA/services/playfab/player-progression/player-data/quickstart)
* [Démarrage rapide de CloudScript](/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)


## Related topics

- [Démarrage rapide des données des joueurs](/fr-CA/services/playfab/player-progression/player-data/quickstart.md)
- [Données de titre](/fr-CA/services/playfab/live-service-management/game-configuration/titledata/index.md)
- [Utilisation des données d'éditeur](/fr-CA/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data.md)
- [Démarrage rapide des actualités de titre](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/news/quickstart.md)
- [Démarrage rapide des schémas](/fr-CA/services/playfab/data-analytics/acting-data/schemas-quickstart.md)
