Pular para o conteúdo principal
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 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.

No servidor de jogo

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

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.
A captura de tela mostra novos dados do título. Captura de tela dos dados do título

Definir dados do título chamando a API de servidor em C#

A API 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.

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.
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.
A captura de tela mostra uma nova substituição de dados do título. A captura de tela mostra como definir uma nova substituição de dados do título. A captura de tela mostra os dados do título e a substituição.

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#

Definir dados internos do título chamando a API de servidor em C#

Confira também

Última modificação em 8 de outubro de 2026