Sintaxe
Parâmetros
entityToken PartyString
O novo token de entidade do PlayFab a ser associado ao usuário local.
Valor retornado
PartyErrorc_partyErrorSuccess se a chamada 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 PartyManager::GetErrorMessage().
Comentários
Este método recebe um token de entidade do PlayFab comoentityToken. Nenhuma validação síncrona é realizada nesse valor. 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 à mesma ID de entidade que foi fornecida à chamada a PartyManager::CreateLocalUser() ou PartyManager::CreateLocalUserWithEntityType() e tem autorização para realizar a operação. Se essas condições não forem atendidas, a operação falhará. Um token de entidade do PlayFab pode ser obtido a partir da saída de uma operação de login do PlayFab e, em seguida, fornecido como entrada para este método. O token deve estar associado à mesma ID e ao mesmo tipo de entidade do PlayFab especificados originalmente para PartyManager::CreateLocalUser() ou PartyManager::CreateLocalUserWithEntityType().
O
entityToken fornecido deve ter sido obtido usando a mesma ID de título que foi passada para PartyManager::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 PartyManager::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 outra chamada a este método.
O chamador é responsável por monitorar a expiração do token de entidade fornecido a este método e a PartyManager::CreateLocalUser() ou PartyManager::CreateLocalUserWithEntityType(). 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 este método. 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.
Requisitos
Cabeçalho: Party.hConfira também
PartyLocalUserPartyManager::GetErrorMessage
PartyManager::CreateLocalUser
PartyManager::CreateLocalUserWithEntityType
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser