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
- Uma conta de desenvolvedor do PlayFab.
- Uma cópia instalada do Unity Editor. Para instalar o Unity para uso pessoal por meio do Unity Hub, ou o Unity+ para uso profissional, consulte Baixar o Unity.
O PlayFab Unity3D SDK oferece suporte ao Unity Editor versão 5.3 (lançado em dezembro de 2015) e posteriores.
- Um projeto do Unity * pode ser qualquer um dos seguintes:
- Um projeto totalmente novo. Para obter mais informações, consulte Iniciando o Unity pela primeira vez.
- Um projeto de tutorial guiado. Para obter mais informações, consulte Introdução ao Unity.
- Um projeto existente.
- O SDK do Unity3D do PlayFab.
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çãoUnicornTossMaster.
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.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, umGetPlayerProfile 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!!!
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.

CreatePlayerAndUpdateDisplayName, 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 usaLoginWithCustomId como exemplo.
Isso funciona com todos os mecanismos de login.
