> ## 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 de dados do título
> Leia e grave pares chave-valor de dados do título do PlayFab a partir de clientes e servidores de jogo usando as APIs GetTitleData e SetTitleData, com exemplos de código em C#.
Os dados do título são o conjunto de pares chave-valor de texto simples usados para armazenar e gerenciar remotamente no servidor os dados de configuração do jogo. Eles mantêm as variáveis de configuração de todo o título acessíveis e organizadas, podendo ser recuperadas no lado do cliente.
Este início rápido descreve como criar e usar dados do título programaticamente.
Este é um tópico importante, pois armazenar os dados de configuração de um jogo remotamente no servidor, onde podem ser alterados a qualquer momento, é um dos motivos mais básicos para usar um serviço como o PlayFab.
## Obter dados do título
### No cliente do jogo
Use [GetTitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata) do `PlayFabClientAPI` para obter os KVPs de um título específico. O exemplo de código a seguir exibe os valores de todos os dados do título.
```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());
}
);
}
```
### No servidor de jogo
Use [GetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitledata) do `PlayFabServerAPI` para obter os KVPs de um título específico. O exemplo de código a seguir exibe os valores de todos os dados do título.
```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());
});
}
```
## Definir dados do título
É improvável que os dados do título mudem com muita frequência. Na maioria das situações, você deve usar os dados do título para dados estáticos que permanecem praticamente inalterados durante a vida útil do título.
Você pode definir os dados do título usando o Game Manager ou uma função da API de servidor.
### Definir dados do título usando o Game Manager
Para adicionar dados primários do título a um título usando o Game Manager, execute as etapas a seguir.
1. Abra o título no **Game Manager**.
2. Selecione **Content** e, em seguida, **Title Data**.
3. Selecione **New Title Data**
4. Na página de novos dados do título, insira um valor para **Key** e um valor para **Value**. Tanto **Key** quanto **Value** são armazenados como cadeias de caracteres.
5. Use o botão **Save** para salvar o novo item de dados.
### Definir dados do título chamando a API de servidor em C\#
A API [SetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.settitledata) é uma API de servidor que você deve chamar a partir de um servidor dedicado. Você só pode definir um KVP de dados do título em cada chamada a `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());
}
);
}
```
### Definir substituições de dados do título usando o Game Manager
Uma substituição também é um conjunto de pares chave-valor JSON e, idealmente, deve ter como finalidade conter a alteração delta necessária nos pares chave-valor dos dados primários do título. A alteração delta pode ser composta por pares chave-valor que, em comparação com os dados primários do título, sejam um novo par chave-valor, uma alteração no valor de uma chave existente ou a exclusão de uma chave (com NULL como entrada do valor).
Para adicionar substituições aos dados primários do título, execute as etapas a seguir.
1. Abra o título no **Game Manager**.
2. Selecione **Content** e, em seguida, **Title Data**.
3. Selecione **New Override**.
4. Insira o Override Label e, além disso, insira um valor para **Key** e um valor para **Value**. Tanto Key quanto Value são armazenados como cadeias de caracteres.
5. Use o botão **Save** para salvar a nova substituição de dados do título.
Por enquanto, esse conjunto de substituição de pares chave/valor só entra em vigor usando [Experiments](/pt-BR/services/playfab/live-service-management/game-configuration/experiments).
Se o jogador pertencer a uma variante de experimento que contenha substituições de dados do título, as substituições serão aplicadas automaticamente no lado do servidor e retornadas com os dados do título no lado do cliente.
Os valores de substituição dos dados do título podem levar até um minuto para serem atualizados e persistirem.
## Dados internos do título
Assim como os dados do usuário, os dados do título têm um armazenamento interno que fica oculto do cliente. Esses dados também podem ser definidos no Game Manager ou por meio de uma API de servidor.
### Obter dados internos do título chamando a API de servidor em 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());
}
);
}
```
### Definir dados internos do título chamando a API de servidor em 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());
});
}
```
## Confira também
* [Usar dados do publicador](/pt-BR/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data)
* [Início rápido de dados do jogador](/pt-BR/services/playfab/player-progression/player-data/quickstart)
* [Início rápido do CloudScript](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)
## Related topics
- [Dados do título](/pt-BR/services/playfab/live-service-management/game-configuration/titledata/index.md)
- [Usar dados do publicador](/pt-BR/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data.md)
- [Início rápido de dados do jogador](/pt-BR/services/playfab/player-progression/player-data/quickstart.md)
- [Início rápido de moeda virtual do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md)
- [Início rápido das Conexões de Dados](/pt-BR/services/playfab/data-analytics/export-data/data-connection-quickstart.md)