A primeira etapa para integrar seu jogo aos serviços relacionados a jogos do Google Play (PGS) é implementar a autenticação de plataforma. Isso é necessário para acessar todos os outros recursos, como conquistas, rankings e eventos.
Como o SDK dos serviços relacionados a jogos do Google Play realiza automaticamente a autenticação da plataforma no lançamento 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 relacionados a jogos do Google Play 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 relacionados a jogos do Google Play 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 relacionados a jogos do Google Play não exigem um botão Fazer login manual.
- ID do jogador:após a autenticação bem-sucedida da plataforma, os serviços relacionados a jogos do Google Play fornecem um ID do jogador estável. Esse ID é consistente em todos os dispositivos para o mesmo jogo. Use esse ID principalmente para rastrear recursos da plataforma, como o progresso das conquistas.
- Desvinculado:não use os Serviços de jogos do Play 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 relacionados a jogos do Google Play funcionam como um identificador de plataforma persistente.
ID 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 relacionados a jogos do Google Play. Sua integração do cliente de jogo, integração do servidor de jogos e serviço de salvamento na nuvem podem usar o ID para acessar com segurança os dados dos jogadores nos serviços relacionados a jogos do Google Play.
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) ou outros provedores como método de login principal.
- Independência:os jogadores podem fazer login nos serviços relacionados a jogos do Google Play (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 relacionados a jogos do Google Play 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 os 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 com o ID do jogador persistente.
Continuidade entre plataformas com o SiWG
Para ajudar os jogadores a manter o progresso no Android, iOS e na Web, use o Login do 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 se 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 relacionados a jogos do Google Play para informar o progresso de um jogador nos recursos do Google Play Games, como conquistas.
Integração recomendada
Para integrar seu jogo aos serviços relacionados a jogos do Google Play, 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 relacionados a jogos do Google Play 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 relacionados a jogos do Google Play, como conquistas e placares.
A autenticação é executada como um processo silencioso em segundo plano durante a inicialização do jogo. Os usuários atuais dos serviços relacionados a jogos do Google Play recebem uma mensagem de boas-vindas após a autenticação. Os usuários que não têm um perfil dos Serviços relacionados a jogos do Google Play 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 relacionados a jogos do Google Play para interagir com a plataforma. Alguns jogadores podem não ter um perfil dos serviços relacionados a jogos do Google Play ao iniciar seu jogo. Esses jogadores vão precisar criar uma.
Os prompts de criação de perfil acionados automaticamente aparecem por padrão quando você inicia um jogo sem um perfil dos Serviços relacionados a jogos do Google Play.
Autenticação no jogo
Depois que a autenticação da plataforma for executada, 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 sem problemas 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 relacionados a jogos do Google Play 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 autenticaçã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 um 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 IGA jogado por último 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 sem problemas.
- 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.
- 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 o jogo e jogar usando uma conta de visitante local. O PGS ainda faz a autenticação em segundo plano. Se o jogador escolher Salvar progresso, o jogo vai converter a sessão de convidado em um IGA permanente e vincular ao ID do jogador do PGS.
