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.
| Propriedade | O que ela informa |
|---|---|
PlayServAuth.IsLoggedIn | Se há um Player com login feito. |
PlayServAuth.PlayerId | O ID do Player no PlayServ, plr_…. Ele não muda quando provedores são adicionados. |
PlayServAuth.SessionKind | Anonymous, ou Registered depois que um provedor é vinculado. None antes do login. |
PlayServAuth.CurrentSession.LinkedProviders | Os 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.
| Provedor | Prova | Pacote complementar |
|---|---|---|
| Apple | FromAppleIdToken(idToken, nonce) | com.playserv.apple-signin, com o Sign in with Apple no iOS |
FromGoogleIdToken(idToken, nonce) | com.playserv.google-signin, sobre o plugin Google Sign-In para Unity | |
FromFacebookLimitedLoginToken(token, nonce); o nonce é obrigatório | com.playserv.facebook-login, com o Limited Login do Meta SDK | |
| Epic | FromEpicExternalAuthToken(token) | com.playserv.epic-auth, com o plugin EOS para Unity |
| Steam | FromSteamTicket(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:
| Modo | Quando usar | O 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. |
RecoverProviderAccount | O 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.
| Regra | Por 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.
Vincular, desvincular e mesclar
| Chamada | O 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.
| Erro | Quando | O que fazer |
|---|---|---|
ProviderAlreadyLinked | A conta do provedor pertence a outro Player. result.Conflict vem preenchido. | Ofereça a mesclagem ou a troca para aquele Player. |
ProviderNotLinked | Ao desvincular um provedor que o Player não tem. | — |
LastProviderUnlinkForbidden | Ao desvincular o último provedor do Player. | Vincule outro provedor antes. |
MergeProviderConflict | Os dois Players têm uma conta do mesmo provedor. | Desvincule uma delas e depois mescle. |
DeviceBanned | Este aparelho está banido. | Avise o jogador; fazer login de novo não vai resolver. |
Forbidden | O Player está banido ou suspenso: Error.BackendCode é player_banned ou player_suspended. | Avise o jogador. |
InvalidCredential · Unauthorized | O 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
- SSO & Auth — ative os provedores e informe as credenciais deles
- Gerenciar Players — as contas que seus jogadores recebem
- Conexão e sessão — como a sessão se mantém viva e quando ela termina
Atualizado em 19 de out. de 2026