Sintaxe
Parâmetros
entityId PartyString
A ID de entidade do PlayFab a ser associada ao usuário local.
titlePlayerEntityToken PartyString
O token de entidade do PlayFab a ser associado ao usuário local.
localUser PartyLocalUser**saída alocada pela biblioteca O objeto de usuário local de saída.
Valor retornado
PartyErrorc_partyErrorSuccess se a criação do usuário local tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de GetErrorMessage().
Comentários
Este método recebe uma ID de entidade do PlayFab comoentityId e um token de entidade do PlayFab como titlePlayerEntityToken. Nenhuma validação síncrona é realizada nesses valores, exceto a verificação de que o comprimento de entityId é menor ou igual a c_maxEntityIdStringLength. Quando a biblioteca realiza operações que exigem autenticação ou autorização do usuário, como criar uma rede, autenticar-se em uma rede ou realizar a transcrição de fala em texto, o serviço do Party validará se o token é válido, não está expirado, está associado à ID de entidade fornecida e tem autorização para realizar a operação. Se essas condições não forem atendidas, a operação falhará. Uma ID de entidade e um token de entidade do PlayFab podem ser obtidos a partir da saída de uma operação de login do PlayFab e, em seguida, fornecidos como entrada para este método. A ID de entidade do PlayFab deve ser do tipo
title_player_account, que, para a maioria dos desenvolvedores, representa o “jogador” da forma mais tradicional. Para criar usuários que representem outros tipos de entidade com suporte, use CreateLocalUserWithEntityType(). O
entityId e o titlePlayerEntityToken fornecidos devem ter sido obtidos usando a mesma ID de título que foi passada para Initialize(). A biblioteca do Party faz uma cópia do token de entidade do PlayFab fornecido para uso em operações subsequentes que exigem autenticação ou autorização do usuário local, como CreateNewNetwork() ou PartyNetwork::AuthenticateLocalUser(). Se o token fornecido a esta chamada estiver expirado ou for inválido de outra forma, as operações que exigem um token válido falharão. Um token novo e válido pode ser fornecido à biblioteca do Party por meio de uma chamada a PartyLocalUser::UpdateEntityToken().
O chamador é responsável por monitorar a expiração do token de entidade fornecido a este método e a PartyLocalUser::UpdateEntityToken(). Quando o token estiver próximo do horário de expiração ou já o tiver ultrapassado, um novo token deverá ser obtido realizando uma operação de login do PlayFab e fornecido à biblioteca do Party chamando PartyLocalUser::UpdateEntityToken(). Recomendamos obter um novo token quando o token fornecido anteriormente atingir a metade do seu período de validade. Em plataformas que podem entrar em um estado de baixo consumo de energia ou que, de outra forma, possam fazer com que o aplicativo pause a execução por um longo período, impedindo que o token seja atualizado antes de expirar, a expiração do token deve ser verificada assim que a execução for retomada.
Somente
c_maxLocalUsersPerDeviceCount objetos PartyLocalUser podem existir simultaneamente a qualquer momento. Este método falhará de forma síncrona se a criação de outro usuário local exceder esse limite. Em caso de retorno bem-sucedido, este método invalida a memória de qualquer matriz retornada anteriormente por GetLocalUsers(), pois adiciona de forma síncrona o novo usuário à matriz. StartProcessingStateChanges() também invalida a memória da matriz. O objeto
localUser retornado será válido até que um PartyDestroyLocalUserCompletedStateChange tenha sido gerado e todas as alterações de estado que fazem referência ao objeto tenham sido devolvidas a FinishProcessingStateChanges().
Requisitos
Cabeçalho: Party.hConfira também
PartyManagerPartyDestroyLocalUserCompletedStateChange
PartyManager::Initialize
PartyManager::GetLocalUsers
PartyManager::CreateLocalUserWithEntityType
PartyManager::DestroyLocalUser
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser
PartyNetwork::RemoveLocalUser
PartyNetwork::CreateInvitation
PartyNetwork::RevokeInvitation
PartyNetwork::CreateEndpoint
PartyLocalUser::UpdateEntityToken
PartyLocalDevice::CreateChatControl