A primeira etapa para integrar seu jogo aos serviços do Google Play Games (PGS) é implementar a autenticação de plataforma. Isso é necessário para acessar todos os outros recursos, como conquistas, placares e eventos.
Como o SDK dos serviços do Google Play Games realiza automaticamente a autenticação da plataforma no lançamento do jogo, é necessário integrar o SDK dos serviços do Google Play Games v2 ao jogo e implementar o fluxo de autenticação recomendado para que o jogo esteja pronto para implementar e atenda às diretrizes de experiência do usuário do Level Up do Google Play Games.
Conceitos de autenticação
Nos serviços do Google Play Games v2, o conceito de "fazer login" é separado em duas camadas distintas: autenticação da plataforma e autenticação no jogo.
Autenticação da plataforma
Os serviços do Google Play Games oferecem uma camada de engajamento da plataforma. Ele gerencia o relacionamento do jogador com o ecossistema do Google Play Games usando o Perfil de jogador para acessar recursos como conquistas, placares e missões. A autenticação de plataforma tem as seguintes características principais:
- Silenciosa e automática:a autenticação ocorre automaticamente em segundo plano quando o jogo é iniciado. Os serviços do Google Play Games não exigem um botão de Login manual.
- ID do jogador:após a autenticação bem-sucedida da plataforma, os serviços do Google Play Games fornecem um ID do jogador estável. Esse ID é consistente em todos os dispositivos para o mesmo jogo. Use esse ID principalmente para acompanhar recursos da plataforma, como o progresso das conquistas.
- Desvinculado:não use os serviços do Google Play Games como o sistema de identidade principal do jogo para gerenciar a conta no jogo (IGA, na sigla em inglês), o progresso ou o inventário do jogador. Os serviços do Google Play Games funcionam como um identificador de plataforma persistente.
Código do jogador
Um ID de jogador é um identificador de uma conta de jogador dos serviços relacionados a jogos do Google Play. Seu jogo pode extrair o ID de qualquer jogador que se conecte usando a autenticação dos serviços do Google Play Games. A integração do cliente do jogo, a integração do servidor de jogos e o serviço de salvamento na nuvem podem usar o ID para acessar com segurança os dados dos jogadores nos serviços do Google Play Games.
Um ID do jogador é consistente para um usuário que acessa o jogo em vários dispositivos. No entanto, ele nem sempre é consistente entre jogos diferentes. Para mais informações, consulte IDs de jogadores de última geração.
Autenticação no jogo
Você gerencia a conta no jogo (IGA, na sigla em inglês), que é o sistema de identidade que vincula o progresso, o inventário e a moeda do jogador no jogo.
- Identidade principal:você pode usar seu próprio back-end, o Fazer login com o Google (SiWG, na sigla em inglês) ou outros provedores como o método de login principal.
- Independência:os jogadores podem fazer login nos serviços do Google Play Games (identidade da plataforma) para ganhar conquistas enquanto estão conectados a qualquer IGA específico, por exemplo, uma conta de convidado ou uma conta SiWG específica.
- Gerenciamento de várias IGAs:os serviços do Google Play Games processam apenas a autenticação da plataforma. O jogo gerencia a autenticação principal dos jogadores nas IGAs. Isso significa que não há mudanças nos fluxos atuais do jogo para que os jogadores alternem entre as IGAs. Quando os jogadores trocam de conta, eles permanecem autenticados na plataforma do Play Games pelo PGS, e você continua enviando os dados relacionados a conquistas e outros recursos do PGS usando o ID do jogador persistente.
Continuidade multiplataforma com o SiWG
Para ajudar os jogadores a manter o progresso no Android, iOS e na Web, use o Login com o Google como método principal de autenticação no jogo. Considere o seguinte:
- Botão "Fazer login com o Google":no PGS v1, o botão Google Play geralmente processava o login na plataforma e no jogo. Na v2, esses são processos separados. Implemente um botão padrão de Fazer login com o Google para que os jogadores autentiquem e acessem o IGA.
- SDKs de Sign-in com o Google:
- Para Android e iOS, use os SDKs padrão do Login do Google para autenticar jogadores nas IGAs.
- Use o Google Open ID como o identificador principal da conta de um jogador no jogo.
- Use o ID do jogador dos serviços do Google Play Games para informar o progresso de um jogador em recursos do Google Play Games, como conquistas.
Integração recomendada
Para integrar seu jogo aos serviços do Google Play Games, siga estas etapas recomendadas:
Inicialização e autenticação
Esta etapa é necessária para inicializar e autenticar seu jogo:
Implemente a autenticação da plataforma inicializando o SDK dos serviços do Google Play Games v2 na inicialização. Para mais informações, consulte autenticação de plataforma para jogos Android. Essa etapa é necessária para acessar recursos dos serviços do Google Play Games, como conquistas e placares.
A autenticação é executada como um processo silencioso em segundo plano durante a inicialização do jogo. Os usuários dos serviços do Google Play Games veem uma mensagem de boas-vindas após a autenticação. Os usuários que não têm um perfil dos serviços do Google Play Games recebem uma solicitação para criar um perfil durante a inicialização do SDK.
Criação de perfil
Os jogadores precisam de um perfil dos serviços do Google Play Games para interagir com a plataforma. Alguns jogadores podem não ter um perfil dos serviços do Google Play Games ao iniciar seu jogo. Esses jogadores vão precisar criar uma. Para decidir a experiência certa para seus usuários, escolha uma das seguintes opções:
Solicitações de criação de perfil acionadas automaticamente
Os prompts de criação de perfil acionados automaticamente aparecem por padrão quando você inicia um jogo sem um perfil dos serviços do Google Play Games.
Parar os avisos de criação de perfil acionados automaticamente
Desative as solicitações de perfil na inicialização configurando o arquivo de manifesto para evitar solicitações acionadas automaticamente. Isso permite que usuários sem um perfil dos serviços do Google Play Games continuem carregando o jogo sem precisar criar um perfil desses serviços.
Embora os usuários possam fazer login com qualquer provedor de identidade, mostre um comando de criação de perfil para incentivar a autenticação com a plataforma do Play Games. Mostre essa solicitação conforme necessário, mas antes que os usuários façam um progresso significativo em recursos como conquistas e rankings.
Considere acionar a solicitação de perfil durante estes momentos recomendados:
- Depois de concluir um tutorial.
- Durante um momento premiado (por exemplo, ganhar uma partida, coletar um item raro ou atingir uma meta).
- Ao iniciar uma segunda sessão.
Para mais informações, consulte Impedir a criação automática de perfis (Java) e Impedir a criação automática de perfis (Unity).
Autenticação no jogo
Depois que a autenticação da plataforma for executada com sucesso, os desenvolvedores precisarão implementar as seguintes etapas para que os jogadores acessem os IGAs, dependendo do estado atual do jogo:
- Se houver uma sessão de jogo ativa no dispositivo, permita que o jogador retome a sessão atual.
- Se não houver uma sessão de jogo ativa:
- No caso de um cenário de restauração perfeita em que um IGA jogado por último está associado ao ID do jogador do PGS, prossiga para restaurar automaticamente o IGA associado.
- Caso contrário, apresente ao jogador a tela de login ou de criação de conta designada do aplicativo. Em seguida, os jogadores podem escolher o método de autenticação preferido para criar ou fazer login em uma IGA.
Escopos do OAuth
Os serviços relacionados a jogos do Google Play dependem do
sistema OAuth
para que o usuário permita que o jogo acesse a conta dele. Os serviços relacionados a jogos do Google Play
têm um escopo exclusivo para jogos (games-lite) e dependem de outro escopo
(drive.appdata) caso o jogo use o recurso de Jogos salvos. O recurso de Jogos salvos
dá acesso à conta do Google Drive do usuário, em que os dados do jogo são
armazenados.
Ao usar o SDK dos serviços do Google Play Games v2, é possível solicitar
escopos OAuth extras.
Se você precisar de outros escopos de OAuth, recomendamos chamar requestServerSideAccess.
Para mais informações, consulte
receber o código de autorização do servidor ou recuperar códigos de autenticação do servidor.
Diretriz de experiência do usuário para um fluxo de autenticação ideal
As diretrizes a seguir explicam o fluxo de autenticação recomendado com a integração do PGS v2. Eles abrangem cenários para usuários novos, atuais e recorrentes, além do modo visitante.
Novo jogador
Esse fluxo se aplica a um usuário que inicia o jogo pela primeira vez em um dispositivo sem histórico de jogo anterior.
- Ao iniciar, o SDK do PGS é inicializado para autenticar a identidade da plataforma do usuário (ID do jogador do PGS).
- Depois desse handshake em segundo plano, o jogo mostra ao jogador opções de criação de IGA, por exemplo, Criar nova conta, Fazer login com o Google ou outros métodos de login social.
- Depois que o jogador cria ou seleciona uma IGA, o jogo vincula essa conta ao identificador principal escolhido no back-end.
- O jogo também vincula esse IGA escolhido ao ID do jogador do PGS, marcando-o como o último IGA jogado para restauração sem problemas.
Jogadores com sessões ativas
Este cenário descreve jogadores que iniciam o jogo em um dispositivo em que já têm uma sessão ativa. O objetivo é oferecer uma experiência de entrada perfeita.
- Quando o jogador inicia o app, o PGS faz a autenticação silenciosamente em segundo plano, fornecendo o ID do jogador para acompanhar o progresso em relação a conquistas e outros recursos dos serviços relacionados a jogos do Google Play.
- Ao mesmo tempo, quando aplicável, o jogo ignora as telas de login e faz login imediato do jogador na sessão ativa do IGA ou no último IGA jogado associado ao ID do jogador, para que ele possa retomar o jogo imediatamente.
Jogadores trocando de conta
Esse fluxo ocorre quando um jogador com uma sessão ativa navega até as configurações do jogo para trocar de conta. Por exemplo, sair de uma conta principal para usar uma conta alternativa.
- O jogador sai da IGA atual, mas a conexão da plataforma do PGS permanece ativa.
- Quando o jogador faz login com uma IGA diferente, o jogo vincula essa nova conta ao ID do jogador do PGS atual como a última IGA jogada apenas para restauração perfeita.
Restauração perfeita para jogadores que retornam
Esse cenário se aplica quando um jogador inicia o jogo após um período de inatividade, uma reinstalação ou em um dispositivo completamente novo. Recomendamos que o jogo implemente a restauração integrada.
- Ao iniciar, o PGS autentica o usuário e fornece o ID do jogador do PGS para o jogo.
- O jogo verifica o back-end (ou o token de recuperação recuperado, se estiver usando a API Recall) para saber se um IGA jogado por último já está vinculado a esse ID do PGS.
- Se um link for encontrado, o jogo vai restaurar automaticamente o progresso do jogador e fazer login, pulando a tela de login manual.
- Caso contrário, o jogo vai mostrar a tela de login do jogador.
- Em seguida, o jogador escolhe um método de login e faz login em um IGA.
- Em seguida, o jogo vincula essa IGA ao ID do jogador do PGS como a última IGA jogada para uma restauração perfeita.
Modo convidado
Os jogadores podem iniciar e jogar usando uma conta de visitante local. Os serviços do Google Play Games ainda autenticam o jogador em segundo plano. Se o jogador selecionar Salvar progresso, o jogo vai converter a sessão de convidado em uma IGA permanente e vinculá-la ao ID do jogador. Para mais informações sobre a resolução de conflitos, consulte Conta de convidado.
