Pular para o conteúdo principal

Acessando o PlayFab com uma entidade de título

Assim como você pode fazer login como jogador e fazer chamadas ao PlayFab, também pode se autenticar como uma entidade de título e fazer chamadas ao PlayFab por meio dela. As entidades de título podem usar determinadas funções que não estão disponíveis para entidades de jogador. Muitas dessas funções têm o prefixo “server”; um exemplo é ServerAddPlayerTag. Obter um identificador de entidade de título envolve as mesmas etapas de inicialização do login como jogador. Consulte a seção “Inicialização” do artigo Início rápido para Win32 para obter detalhes. Observação: no momento, as funções de servidor estão disponíveis apenas na versão Win32 do SDK.

Autenticando uma entidade de título

Depois de criar um PFServiceConfigHandle nas etapas iniciais, você pode obter um identificador de entidade de título chamando PFAuthenticationGetEntityWithSecretKeyAsync. Depois que a chamada para obter a entidade for concluída com êxito, ela retornará S_OK junto com um PFEntityHandle. Esse processo é semelhante ao login como jogador. O tipo de retorno PFEntityHandle é o mesmo, exceto que, nesse caso, o identificador de entidade representa uma entidade de título em vez de uma entidade de jogador. Podemos chamar essa entidade de servidor de jogo.

Chamadas de serviço

Depois que o servidor de jogo for criado, você poderá fazer chamadas ao back-end do PlayFab. Veja um exemplo de como adicionar marcas de jogador a um jogador específico no título.
Assim como no exemplo de AddPlayerTag, muitas das funções usadas por um servidor de jogo envolvem obter ou alterar dados de jogadores. Essa função exige a PlayFab ID do jogador específico. Os clientes conectados podem fornecer as PlayFab IDs, ou o servidor pode recuperá-las diretamente do PlayFab por meio de chamadas como GetPlayFabIDsFromXboxLiveIDs.

Referência

Documentação de referência da API
Última modificação em 8 de outubro de 2026