Sintaxe
Parâmetros
handle PFMultiplayerHandle
O identificador da instância da API PFMultiplayer.
entity PFEntityKey*
A chave de entidade do PlayFab a ser associada a um token.
entityToken char*terminada em nulo A definir
Valor retornado
Tipo: HRESULTS_OK 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 PFMultiplayerGetErrorMessage().
Comentários
Este método recebe uma chave de entidade do PlayFab comoentity e um token de entidade do PlayFab como token. Quando a biblioteca executa operações em nome de uma entidade que exigem autenticação ou autorização, como criar ou atualizar um lobby, a biblioteca procura um token associado à entidade para usar na operação. Se nenhum token tiver sido definido anteriormente para a entidade, a operação falhará de forma síncrona. Durante a operação assíncrona, o serviço PlayFab validará se o token é válido, não expirou, está associado à ID de entidade fornecida e está autorizado a executar a operação. Se essas condições não forem atendidas, a operação falhará. Uma chave de entidade e um token de entidade do PlayFab podem ser obtidos da saída de uma operação de login do PlayFab e, em seguida, fornecidos como entrada para este método.
A
entity e o token fornecidos precisam ter sido obtidos usando a mesma Title ID do PlayFab que foi passada para PFMultiplayerInitialize(). A biblioteca Multiplayer 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
PFMultiplayerCreateAndJoinLobby. Se o token fornecido a esta chamada estiver expirado ou for inválido por outro motivo, as operações que exigem um token válido falharão. Um token novo e válido pode ser fornecido à biblioteca Multiplayer chamando este método novamente com a mesma chave de entidade. O chamador é responsável por monitorar a expiração do token de entidade fornecido a este método. Quando o token estiver próximo do horário de expiração ou já tiver passado dele, um novo token deverá ser obtido executando uma operação de login do PlayFab e fornecido à biblioteca Multiplayer chamando este método novamente. É recomendável obter um novo token quando o token fornecido anteriormente estiver na metade do período de validade. Em plataformas que podem entrar em um estado de baixo consumo de energia ou, de outra forma, fazer com que o aplicativo pause a execução por muito tempo, impedindo que o token seja atualizado antes de expirar, a expiração do token deve ser verificada assim que a execução for retomada.
Nenhuma validação síncrona é executada nesses valores.
Requisitos
Cabeçalho: PFMultiplayer.hConfira também
Membros do PFMultiplayerPFMultiplayerInitialize