Pular para o conteúdo principal
Este tutorial descreve como criar e usar dados com escopo de namespace por meio das APIs de dados do publicador. Os dados do publicador são dados estáticos que abrangem mais de um título em um namespace do PlayFab, como quando vários jogos precisam compartilhar informações comuns. Publisher é o termo de API mais antigo para o escopo de namespace, e a Publisher ID identifica o namespace. Um namespace é diferente de um estúdio, que é o agrupamento administrativo de títulos, usuários, permissões e cobrança. Para obter mais informações, consulte Conceitos do PlayFab.
Esta categoria também inclui dados de jogadores que abrangem vários jogos. O PlayFab armazena os dados como pares chave/valor (KVPs).
A maioria dessas APIs são APIs de servidor que seu programa deve chamar a partir de um servidor dedicado ou por meio de uma função do CloudScript no serviço PlayFab. Você deve chamar as APIs de servidor a partir de um servidor dedicado ou por meio de uma função do CloudScript no serviço PlayFab. Isso é intencional, pois as APIs de servidor do PlayFab exigem que você forneça sua chave secreta.
Não recomendamos usar APIs de servidor em um cliente de jogo. Se precisar usar uma API de servidor, use o CloudScript para esse tipo de funcionalidade.
Os valores dos dados do publicador são copiados e distribuídos para potencialmente centenas de máquinas no cluster de servidores do PlayFab. Como parte desse processo, esses dados são armazenados em cache, e as alterações podem levar até quinze minutos para serem atualizadas nesses caches.
Os dados do publicador são mais adequados para dados globais constantes/estáticos e não são adequados nem confiáveis como variáveis globais.

Dados do publicador

Os dados do publicador são usados para armazenar dados estáticos dos títulos de um namespace. Cada entrada não está vinculada a uma entidade de jogador (ao contrário dos dados do publicador do usuário).

Definir dados do publicador

O trecho a seguir demonstra como definir dados do publicador usando a Server API.
Há uma contraparte na Admin API para esta operação.

Obter dados do publicador

O trecho a seguir demonstra como obter dados do publicador usando a Client API.
Há contrapartes na Server API e na Admin API para esta operação.

Dados do publicador do usuário

Os dados do publicador do usuário podem ser usados para introduzir dados do publicador vinculados a um usuário (jogador) do PlayFab. Ao contrário dos dados do publicador normais, um aplicativo cliente pode alterar os dados do publicador do usuário. O PlayFab expõe 3 níveis de proteção para os dados do publicador do usuário do ponto de vista da Client API:
  1. Os dados do publicador do usuário normais expõem acesso de leitura e gravação para aplicativos cliente.
    • Definidos pela Client API, Server API e Admin API.
    • Obtidos pela Client API, Server API e Admin API.
    • A Client API só pode definir dados do publicador para um jogador que esteja conectado no momento.
  2. Os dados do publicador do usuário somente leitura expõem acesso de leitura para aplicativos cliente.
    • Definidos pela Server API e Admin API.
    • Obtidos pela Client API, Server API e Admin API.
  3. Os dados do publicador do usuário internos não expõem nenhum acesso para aplicativos cliente e são usados para armazenar a parte secreta dos dados do usuário.
    • Definidos pela Server API e Admin API.
    • Obtidos pela Server API e Admin API.

Definir dados do publicador do usuário

O trecho a seguir demonstra como definir os 3 tipos de dados do publicador usando as Client APIs e Server APIs.

Obter dados do publicador do usuário

O trecho a seguir demonstra como obter os 3 tipos de dados do publicador usando as Client APIs e Server APIs.

Confira também

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