A primeira etapa na integração do jogo aos serviços do Google Play Games (PGS) é a implementação da autenticação da plataforma. Isso é necessário para acessar todos os outros recursos, como conquistas, placares e eventos.
Como o SDK dos serviços relacionados a jogos do Google Play realiza a autenticação da plataforma automaticamente na inicialização do jogo, é necessário integrar o SDK do PGS v2 ao jogo e implementar o fluxo de autenticação recomendado para que o jogo esteja pronto para implementar e atender à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 da 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 Fazer login manual.
- ID do jogador:após a autenticação 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.
- Desacoplado:não use os serviços do Google Play Games como o sistema de identidade principal do jogo para gerenciar a conta do jogador no jogo (IGA, na sigla em inglês), o progresso do jogo ou o inventário. Os serviços do Google Play Games servem como um identificador de plataforma persistente.
Código do jogador
Um ID de jogador é um identificador de uma conta de jogador dos serviços do Google Play Games. 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, 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), que é o sistema de identidade que vincula o progresso, o inventário e a moeda do jogador no jogo.
- Identidade principal:é possível 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ífica (por exemplo, uma conta de convidado ou uma conta específica do SiWG).
- 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 pelos serviços relacionados a jogos do Google Play, e você continua enviando os dados relacionados a conquistas e outros recursos dos serviços relacionados a jogos do Google Play em relação ao 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 um método principal de autenticação no jogo. Considere o seguinte:
- Botão "Fazer login com o Google":nos serviços relacionados a jogos do Google Play v1, o botão Google Play geralmente processava o login da plataforma e do jogo. Na v2, esses são processos separados. Implemente um botão padrão Fazer login com o Google para que os jogadores se autentiquem e acessem a IGA.
- SDKs de Login do Google:
- Para Android e iOS, use os SDKs padrão de Login do Google para autenticar os jogadores nas IGAs.
- Use o Google Open ID como o identificador principal de uma conta de jogador no jogo.
- Use o ID do jogador dos serviços do Google Play Games para informar o progresso de um jogador nos recursos do Play Games, como conquistas.
Integração recomendada
Para integrar o 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 o 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 da plataforma para jogos Android. Essa etapa é necessária para acessar os 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 bem-sucedida. Os usuários que não têm um perfil dos serviços do Google Play Games são solicitados a 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 quando iniciam o jogo. Esses jogadores serão solicitados a criar um.
Os avisos 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.
Autenticação no jogo
Depois que a autenticação da plataforma for executada com sucesso, os desenvolvedores precisarão implementar as etapas a seguir para que os jogadores acessem as 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 uma IGA reproduzida por último está associada ao ID do jogador dos serviços relacionados a jogos do Google Play, prossiga para restaurar automaticamente a IGA associada.
- Caso contrário, apresente ao jogador a tela de login ou de criação de conta designada do aplicativo. Os jogadores podem escolher o método de autenticação preferido para estabelecer ou fazer login em uma IGA.
Escopos do OAuth
Os serviços relacionados a jogos do Google Play dependem do
sistema OAuth
para que os jogadores permitam que o jogo acesse a conta deles. 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 o fluxo de autenticação ideal
As diretrizes a seguir explicam o fluxo de autenticação recomendado com a integração dos serviços relacionados a jogos do Google Play v2. Elas abrangem cenários para usuários novos, atuais e recorrentes, além do modo convidado.
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.
- Na inicialização, o SDK dos serviços relacionados a jogos do Google Play é inicializado para autenticar a identidade da plataforma do usuário (ID do jogador dos serviços relacionados a jogos do Google Play).
- Após esse handshake em segundo plano, o jogo mostra opções de criação de IGA ao jogador, 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 essa IGA escolhida ao ID do jogador dos serviços relacionados a jogos do Google Play, marcando-a como a última IGA reproduzida para restauração perfeita.
Jogadores com sessões ativas
Esse 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, os serviços relacionados a jogos do Google Play autenticam silenciosamente em segundo plano, fornecendo o ID do jogador para acompanhar o progresso em relação a conquistas e outros recursos do Play Games.
- Simultaneamente, quando aplicável, o jogo ignora as telas de login e conecta imediatamente o jogador à sessão de IGA ativa ou à última IGA reproduzida associada ao ID do jogador, para que ele possa retomar o jogo imediatamente.
Jogadores que trocam 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, fazer logout de uma conta principal para usar uma conta alternativa.
- O jogador sai da IGA atual, mas a conexão da plataforma PGS permanece ativa.
- Quando o jogador faz login com uma IGA diferente, o jogo vincula essa nova conta ao ID do jogador dos serviços relacionados a jogos do Google Play atual como a última IGA reproduzida apenas para restauração perfeita.
Restauração perfeita para jogadores recorrentes
Esse cenário se aplica quando um jogador inicia o jogo após um período inativo, uma reinstalação ou em um dispositivo completamente novo. Recomendamos que o jogo implemente a restauração perfeita.
- Na inicialização, os serviços relacionados a jogos do Google Play autenticam o usuário e fornecem o ID do jogador dos serviços relacionados a jogos do Google Play ao jogo.
- O jogo verifica o back-end (ou o token de recuperação recuperado, se estiver usando a API Recall) para saber se uma IGA reproduzida por último já está vinculada a esse ID dos serviços relacionados a jogos do Google Play.
- Se um link for encontrado, o jogo vai restaurar automaticamente o progresso do jogador e fazer login, ignorando completamente a tela de login manual.
- Caso contrário, o jogo vai apresentar a tela de login ao jogador
- O jogador escolhe um método de login e faz login em uma IGA.
- O jogo vincula essa IGA ao ID do jogador dos serviços relacionados a jogos do Google Play como a última IGA reproduzida para restauração perfeita.
Modo convidado
Os jogadores podem iniciar o jogo e jogar usando uma conta de convidado 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.
