Pular para o conteúdo principal
Authentication e Players

Esta página ainda não foi traduzida: mostrando a versão em inglês.

Login do usuário

Todo jogador começa como um Player anônimo e faz login com um provedor quando quer manter a conta. PlayServ.Connect() cria o Player anônimo na primeira execução e o restaura nas seguintes. Ao fazer login com Apple, Google, Facebook, Epic ou Steam, o provedor é vinculado a esse mesmo Player, e nada do que o jogador fez como convidado se perde.

using Playserv.Identity;
using Playserv.Wrapper;
using UnityEngine;

// After PlayServ.Connect(): attach Google to the current player.
var result = await PlayServAuth.LoginExternalAsync(PlayServExternalIdentityProof.FromGoogleIdToken(idToken));
if (result.Status == PlayServAuthOperationStatus.Success)
    Debug.Log($"Signed in as {PlayServAuth.PlayerId}");

Os provedores que seus jogadores podem usar são ativados para o Project em SSO & Auth.


Players anônimos

Quando o jogo se conecta com uma client key, o SDK faz o login de um Player anônimo: um novo na primeira execução e o salvo nas seguintes. Não é preciso fazer mais nada. Veja em Connection & Session como a sessão é mantida.

PropriedadeO que ela informa
PlayServAuth.IsLoggedInSe há um Player com login feito.
PlayServAuth.PlayerIdO ID do Player no PlayServ, plr_…. Ele não muda quando provedores são adicionados.
PlayServAuth.SessionKindAnonymous, ou Registered depois que um provedor é vinculado. None antes do login.
PlayServAuth.CurrentSession.LinkedProvidersOs provedores vinculados ao Player.

Para dar nome a um novo Player anônimo — inclusive ao que é criado depois de um logout —, defina AnonymousDisplayName nas configurações do SDK pelo código, antes de conectar. Isso não renomeia um Player que já existe.


Login com um provedor

Obtenha o token do jogador no provedor, transforme-o em uma prova (proof) e passe-a para LoginExternalAsync.

ProvedorProvaPacote complementar
AppleFromAppleIdToken(idToken, nonce)com.playserv.apple-signin, com o Sign in with Apple no iOS
GoogleFromGoogleIdToken(idToken, nonce)com.playserv.google-signin, sobre o plugin Google Sign-In para Unity
FacebookFromFacebookLimitedLoginToken(token, nonce); o nonce é obrigatóriocom.playserv.facebook-login, com o Limited Login do Meta SDK
EpicFromEpicExternalAuthToken(token)com.playserv.epic-auth, com o plugin EOS para Unity
SteamFromSteamTicket(ticket)com.playserv.steam-auth, com o Steamworks.NET

Os pacotes complementares são auxiliares opcionais que obtêm o token do provedor para você; você também pode montar a prova a partir de um token que já tem. Instale e ative os pacotes em Tools ▸ PlayServ ▸ Settings, nas configurações dos módulos do SDK. Acrescente .WithDisplayName(name) à prova para dar nome ao Player quando a conta for criada ou vinculada pela primeira vez.

LoginExternalAsync(proof, mode) decide o que acontece com o Player anônimo atual. mode é um PlayServExternalLoginMode:

ModoQuando usarO que acontece
PreserveCurrentPlayer (padrão)O jogador está fazendo login no aparelho em que já vinha jogando.O provedor é vinculado ao Player atual, que mantém o ID e o progresso.
RecoverProviderAccountO jogador está recuperando a conta em um aparelho novo.O Player dono daquela conta do provedor substitui o anônimo.

O Status do resultado é Success, Conflict ou Failed. Um conflito significa que a conta do provedor já pertence a outro Player: o Player atual é mantido e result.Conflict descreve o outro, para que você ofereça a mesclagem ou a troca. Depois de um login bem-sucedido, o jogo se reconecta com a nova sessão.

PlayServAuth.GetProvidersAsync() lista todos os provedores com as flags Enabled e Available; mostre os disponíveis na sua tela de login.


Login pelo navegador

PlayServAuth.LoginBrowserAsync(provider, options) faz o login do jogador na própria página web do provedor, em WebGL, em builds desktop e no Editor. No WebGL abre um popup; no desktop e no Editor, o navegador do sistema. O SDK espera até 5 minutos para o jogador concluir.

RegraPor quê
No WebGL, chame direto de um handler de clique.Caso contrário, o navegador bloqueia o popup e o resultado é BrowserPopupBlocked.
Faça um login pelo navegador de cada vez.Um segundo retorna BrowserFlowInProgress.
Defina AllowPlayerSwitch = true para permitir a troca de Player.Se a conta do provedor pertencer a outro Player, o resultado é BrowserPlayerSwitchRequired, a menos que você permita a troca.

O login pelo navegador nunca vincula nem mescla contas.


ChamadaO que faz
LinkIdentityAsync(proof)Vincula outro provedor ao Player atual. Um Player tem uma conta por provedor.
UnlinkIdentityAsync("google")Remove um provedor. O último não pode ser removido.
MergeIdentityAsync(conflict, choice, freshProof)Junta o Player atual e o do conflito em um só. choice é PlayServMergeChoice.KeepCurrentPlayer ou UseConflictingPlayer; freshProof é uma nova prova do provedor em conflito.

A mesclagem move os logins, não o progresso

Os provedores do Player mesclado passam para o que permanece. O progresso, as compras e os Records do Player mesclado ficam com ele e não são copiados.


O perfil do Player

PlayServAuth.GetCurrentPlayerProfileAsync() retorna o perfil do próprio Player com login feito, carregando-o uma única vez; RefreshCurrentPlayerProfileAsync() carrega de novo.


Logout

PlayServAuth.LogoutAsync() encerra a sessão na plataforma, limpa a sessão no aparelho e faz o login de um novo Player anônimo. Se não foi possível avisar a plataforma, o erro do resultado informa isso; de qualquer forma, o aparelho fica deslogado.


Quando o login falha

As falhas voltam no Error do resultado. Só lançam exceção: o cancelamento, um argumento ausente ou inválido e uma chamada feita enquanto o jogo está conectando ou reconectando.

ErroQuandoO que fazer
ProviderAlreadyLinkedA conta do provedor pertence a outro Player. result.Conflict vem preenchido.Ofereça a mesclagem ou a troca para aquele Player.
ProviderNotLinkedAo desvincular um provedor que o Player não tem.—
LastProviderUnlinkForbiddenAo desvincular o último provedor do Player.Vincule outro provedor antes.
MergeProviderConflictOs dois Players têm uma conta do mesmo provedor.Desvincule uma delas e depois mescle.
DeviceBannedEste aparelho está banido.Avise o jogador; fazer login de novo não vai resolver.
ForbiddenO Player está banido ou suspenso: Error.BackendCode é player_banned ou player_suspended.Avise o jogador.
InvalidCredential · UnauthorizedO token do provedor foi recusado ou expirou.Obtenha um novo token no provedor e tente de novo.

Banimento e suspensão são definitivos para este login

Um aparelho ou uma conta banidos não conseguem fazer login até que um operador suspenda o bloqueio em Players. Não fique repetindo tentativas.

Se a plataforma encerrar a sessão mais tarde, por exemplo depois de um banimento, PlayServAuth.SessionLost é disparado: veja Connection & Session.

Usar o seu próprio servidor de autenticação, via PlayServ Auth Token ou PlayServ Webhook, chega em breve.


Próximos passos

Atualizado em 19 de out. de 2026