Pular para o conteúdo principal

Tutorial: obter um perfil de jogador

Neste tutorial, você aprenderá a:
[!div class=“checklist”] * Criar um usuário com um nome de exibição * Fazer uma chamada de perfil de jogador * Obter a hora de criação do jogador e a hora do último login * Configurar as restrições de exibição do perfil de jogador do título * Obter o perfil de jogador por meio da operação de login

Requisitos

O PlayFab Unity3D SDK oferece suporte ao Unity Editor versão 5.3 (lançado em dezembro de 2015) e posteriores.
Para este tutorial, é necessário um conhecimento básico de como criar um jogador para o seu título, para que você possa executar um GetPlayerProfile no jogador. Também vale a pena ler o Início rápido do Game Manager se você não estiver familiarizado com o Game Manager, pois é nele que configuramos as restrições de perfil. Os exemplos em C# deste artigo foram escritos para o SDK do Unity. O SDK do Unity usa um modelo orientado a eventos para tratar tarefas não síncronas. Para executar o código de exemplo usando o SDK do C#, você precisa modificar o código para usar um modelo de Task assíncrono. Os métodos que precisam ser modificados têm Async acrescentado ao nome do método na assinatura. Por exemplo, SetObject no SDK do Unity se torna SetObjectAsync no SDK do C#. Para obter mais informações, consulte Programação assíncrona com async e await.

Criar um usuário com um nome de exibição

A primeira etapa é criar um jogador e adicionar um nome de exibição ao usuário. Este exemplo criará um novo usuário com o nome de exibição UnicornTossMaster.
A saída do console deve mostrar:

Fazer uma chamada de perfil de jogador

A próxima etapa é criar um perfil bem básico para o jogador usando O exemplo a seguir usa uma chamada básica a GetPlayerProfile.
A resposta inclui um objeto PlayerProfileModel que contém o nome de exibição UnicornTossMaster do jogador.

Obter a hora de criação do jogador e a hora do último login

No objeto PlayerProfileModel, há uma boa quantidade de dados sobre o jogador. Na etapa anterior, um GetPlayerProfile foi emitido, e a resposta recebida continha apenas as informações do nome de exibição. A próxima etapa é obter ainda mais dados de perfil do jogador. Para isso, chame GetPlayerProfile com campos adicionais no parâmetro de solicitação PlayerProfileViewConstraints. O exemplo em C# a seguir modifica o método GetPlayerProfile da etapa 2 e chama GetPlayerProfile para solicitar os campos Created e LastLogin, definindo seus sinalizadores em ProfileConstraints.
Esta chamada não terá êxito nesta etapa!!!
Se você executar este código de exemplo neste ponto, ele retornará um erro com Error Code 1303. RequestViewConstraintParamsNotAllowed e uma mensagem de erro informando que há Invalid view constraints, com uma saída JSON das restrições definidas atualmente no título. O erro ocorre porque você ainda não configurou a capacidade de mostrar Created e LastLogin nas configurações de restrição de perfil do seu título.

Configurar as restrições de exibição do perfil de jogador do título

Para obter mais dados ao chamar a API GetPlayerProfile, você precisa configurar as restrições para que os dados fiquem disponíveis. Essas configurações ficam nas configurações do título no Game Manager. Por padrão, ALLOW CLIENT ACCESS TO PROFILE PROPERTIES: tinha somente Display name habilitado, o que permitia recuperar o valor de Display Name. Para configurar restrições adicionais para o título:
  • No Game Manager, selecione seu título.
  • Selecione o ícone de engrenagem no canto superior esquerdo e, em seguida, selecione Title settings.
  • Selecione a guia Client Profile Options.
  • Para habilitar Created e LastLogin em ProfileConstraints, marque Creation date e Last login time e selecione SAVE CLIENT PROFILE OPTIONS.
Configurações do PlayFab * Client Profile Options * Allow client access to profile properties Agora, ao chamar 1CreatePlayerAndUpdateDisplayName, ele retorna o objeto PlayerProfileModel com os dados de hora de criação do usuário, do último login e o nome de exibição UnicornTossMaster.

Obter o perfil de jogador por meio da operação de login

Na maioria dos casos, você vai querer recuperar os dados de perfil do jogador assim que ele fizer login. A API do PlayFab permite combinar a chamada de login e a chamada para recuperar o perfil do jogador em uma única chamada. O exemplo a seguir mostra como obter informações de perfil por meio de uma solicitação de login e usa LoginWithCustomId como exemplo.
Isso funciona com todos os mecanismos de login.
Última modificação em 8 de outubro de 2026