Autenticação da plataforma

A primeira etapa para integrar seu jogo aos serviços do Google Play Games (PGS) é implementar a autenticação da 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 na inicialização do jogo, é necessário integrar o SDK dos 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 a relação 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 na 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 os recursos da plataforma, como o progresso de conquistas.
  • Desacoplado: 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 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 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: é possível usar seu próprio back-end, o recurso Fazer login com o Google (SiWG) 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, como uma conta de visitante 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. Seu 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 para o ID do jogador persistente.

Continuidade multiplataforma com o SiWG

Para ajudar os jogadores a manter o progresso no Android, no iOS e na Web, use o Fazer login com o Google como método principal de autenticação no jogo. Considere o seguinte:

  • Botão "Fazer login com o Google": na v1 dos PGS, o botão do Google Play geralmente lidava com o login na plataforma e no 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 o IGA.
  • SDKs do Login do Google:
    • No Android e no iOS, use os SDKs padrão do Login do Google para autenticar os jogadores nas IGAs.
    • Use o OpenID do Google como o identificador principal da conta de um jogador no jogo.
    • Use o ID de 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 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 dos serviços do Google Play Games 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 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 o lançamento 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 do Google Play Games recebem uma solicitação para criar um perfil durante a inicialização do SDK.

Solicitação de login automático

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 o jogo. Esses jogadores vão precisar criar uma. Para decidir qual é a melhor experiência para seus usuários, escolha uma das seguintes opções:

Solicitações de criação de perfil acionadas automaticamente

As solicitações de criação de perfil acionadas automaticamente aparecem por padrão quando você inicia um jogo sem um perfil dos serviços do Google Play Games.

Solicitação de criação de perfil ao iniciar um jogo.
Solicitação de criação de perfil ao iniciar um jogo (clique para ampliar).

Interromper as solicitações de criação de perfil acionadas 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 que seja solicitado que criem um perfil dos serviços do Google Play Games.

Embora os usuários possam fazer login com qualquer provedor de identidade, mostre uma solicitação 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 placares.

Considere acionar o comando de perfil nestes momentos recomendados:

  • Depois de concluir um tutorial.
  • Durante um momento de recompensa (por exemplo, vencer uma partida, coletar um item raro ou atingir um marco).
  • No momento de iniciar uma segunda sessão.

Para mais informações, consulte Impedir a criação de perfis acionada automaticamente (Java) e Impedir a criação de perfis acionada automaticamente (Unity).

Autenticação no jogo

Depois que a autenticação da plataforma for executada, os desenvolvedores precisarão implementar as etapas a seguir para que os jogadores acessem as IGAs, dependendo do estado atual do jogo:

  1. Se houver uma sessão de jogo ativa no dispositivo, permita que o jogador retome a sessão atual.
  2. Se não houver uma sessão de jogo ativa:
    1. No caso de um cenário de restauração integrada, em que um IGA jogado pela última vez está associado ao ID de jogador dos serviços relacionados a jogos do Google Play, prossiga para restaurar automaticamente o IGA associado.
    2. Caso contrário, apresente ao jogador a tela de login ou de criação de conta do seu aplicativo. Os jogadores podem escolher o método de autenticação preferido para estabelecer ou fazer login em uma IGA atual.

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 autenticação do servidor ou Extrair 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 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.

  1. Ao ser iniciado, o SDK dos PGS é inicializado para autenticar a identidade da plataforma do usuário (ID de jogador dos PGS).
  2. Após esse handshake em segundo plano, o jogo mostra opções de criação de IGA para o jogador, por exemplo, Criar nova conta, Fazer login com o Google ou outros métodos de login social.
  3. Depois que o jogador cria ou seleciona uma IGA, o jogo vincula essa conta ao identificador principal escolhido no back-end.
  4. O jogo também vincula essa IGA escolhida ao ID do jogador dos PGS, marcando-a como a última IGA jogada para a restauração integrada.
Novo jogador com perfil dos PGS conectado
Novo jogador com perfil dos Serviços relacionados a jogos do Google Play conectado (clique para ampliar).
Novo jogador sem perfil dos PGS
Novo jogador sem perfil dos serviços relacionados a jogos do Google Play (clique para ampliar).
Novo jogador com perfil dos PGS conectado
Novo jogador com perfil dos Serviços relacionados a jogos do Google Play conectado (clique para ampliar).

Jogadores com sessões ativas

Esse cenário descreve os jogadores iniciando o jogo em um dispositivo em que já têm uma sessão ativa. O objetivo é oferecer uma experiência de entrada perfeita.

  1. Quando o jogador inicia o app, os PGS fazem a autenticação silenciosa em segundo plano, fornecendo o ID do jogador para acompanhar o progresso em relação às conquistas e outros recursos dos serviços relacionados a jogos do Google Play.
  2. Ao mesmo tempo, quando aplicável, o jogo ignora as telas de login e conecta imediatamente o jogador à sessão ativa do IGA ou ao último IGA jogado associado ao ID do jogador, para que ele possa retomar o jogo imediatamente.
Iniciar o jogo no mesmo dispositivo com o perfil dos PGS conectado
Inicie o jogo no mesmo dispositivo com o perfil dos PGS conectado (clique para ampliar).
Iniciar o jogo no mesmo dispositivo com o perfil dos PGS desconectado
Inicie o jogo no mesmo dispositivo com o perfil dos PGS desconectado (clique para ampliar).
Iniciar o jogo no mesmo dispositivo sem um perfil dos PGS
Inicie o jogo no mesmo dispositivo sem um perfil dos PGS (clique para ampliar).
Iniciar o jogo em um novo dispositivo com o perfil dos PGS conectado e uma IGA vinculada
Inicie o jogo em um novo dispositivo com o perfil dos PGS conectado e um IGA vinculado (clique para ampliar).
Iniciar o jogo em um novo dispositivo com um perfil dos PGS conectado e sem uma IGA vinculada
Inicie o jogo em um novo dispositivo com o perfil dos PGS conectado e sem uma IGA vinculada (clique para ampliar).
Iniciar o jogo em um novo dispositivo com um perfil dos serviços relacionados a jogos do Google Play desconectado
Inicie o jogo no novo dispositivo com o perfil dos PGS desconectado (clique para ampliar).
Iniciar o jogo em um novo dispositivo sem um perfil dos PGS
Inicie o jogo em um novo dispositivo sem um perfil dos PGS (clique para ampliar).

Jogadores que trocam de conta

Esse fluxo ocorre quando um jogador com uma sessão ativa acessa as configurações do jogo para trocar de conta. Por exemplo, sair de uma conta principal para usar uma conta alternativa.

  1. O jogador sai do IGA atual, mas a conexão com a plataforma dos PGS permanece ativa.
  2. Quando o jogador faz login com uma IGA diferente, o jogo vincula essa nova conta ao ID do jogador dos PGS atual como a última IGA jogada apenas para restauração sem problemas.
Mudar para uma IGA não vinculada a nenhum perfil dos Serviços relacionados a jogos do Google Play
Mudar para uma IGA não vinculada a nenhum perfil do PGS (clique para ampliar).
Mudar para um IGA vinculado ao mesmo perfil dos PGS conectado
Mudar para um IGA vinculado ao mesmo perfil dos PGS conectado (clique para ampliar).
Mudar para uma IGA vinculada a um perfil diferente dos PGS
Mudar para um IGA vinculado a um perfil diferente do PGS (clique para ampliar).
Troca de IGA sem perfil dos PGS no dispositivo
Alternar para o IGA sem um perfil dos PGS no dispositivo (clique para ampliar).
Trocar de IGA com o perfil dos PGS desconectado
Como trocar de IGA com o perfil dos PGS desconectado (clique para ampliar).
Mudar para um IGA que não existe
Mudar para um IGA que não existe (clique para ampliar).

Restauração sem interrupções 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.

  1. No lançamento, os PGS autenticam o usuário e fornecem o ID de jogador dos PGS ao jogo.
  2. O jogo verifica o back-end (ou o token de recuperação recuperado, se estiver usando a API Recall) para conferir se uma IGA jogada pela última vez já está vinculada a esse ID dos serviços relacionados a jogos do Google Play.
  3. Se um vínculo for encontrado, o jogo vai restaurar automaticamente o progresso do jogador e fazer login, pulando totalmente a tela de login manual.
  4. Caso contrário, o jogo apresenta ao jogador a tela de login.
    1. O jogador escolhe um método de login e faz login em um IGA
    2. Em seguida, o jogo vincula esse IGA ao ID do jogador dos PGS como o último IGA jogado para uma restauração perfeita.
Jogador que retorna com o perfil dos PGS desconectado
Jogador que retornou com o perfil dos Serviços relacionados a jogos do Google Play desconectado (clique para ampliar).
Jogador que retorna com perfil do PGS conectado e IGA vinculada
Jogador que retorna com perfil dos PGS conectado e IGA vinculado (clique para ampliar).
Jogador que já usou o jogo, com perfil dos PGS conectado e sem IGA vinculada
Jogador que retorna com um perfil dos PGS conectado e sem IGA vinculado (clique para ampliar).
Jogador recorrente sem um perfil dos PGS
Jogador que está voltando sem perfil dos PGS (clique para ampliar).

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 visitante em uma IGA permanente e vinculá-la ao ID do jogador. Para mais informações sobre a resolução de conflitos, consulte Conta de visitante.

Modo visitante: nenhum IGA criado
Modo visitante: nenhum IGA criado (clique para ampliar).
Modo visitante: IGA criado
Modo visitante: IGA criado (clique para ampliar).

Testar o jogo

Teste o jogo para garantir que ele funcione conforme o esperado. Os testes realizados dependem dos recursos do jogo.

Confira a seguir uma lista de testes comuns para executar.

  1. Login bem-sucedido.

    1. O login automático funciona. O usuário precisa fazer login nos serviços do Google Play Games ao iniciar o jogo.

    2. O pop-up de boas-vindas é exibido.

      Exemplo de pop-up de boas-vindas.
      Exemplo de pop-up de boas-vindas (clique para ampliar).

    3. As mensagens de registro bem-sucedidas são exibidas. Execute o seguinte comando no terminal:

      adb logcat | grep com.google.android.

      Uma mensagem de registro bem-sucedida é mostrada no exemplo a seguir:

      [$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc
      number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup.
      [CONTEXT service_id=1 ]
  2. Garantir a consistência dos componentes da interface.

    1. Pop-ups, placares e conquistas são exibidos de forma correta e consistente em vários tamanhos e orientações de tela na interface do usuário (IU) dos serviços do Google Play Games.

    2. A opção de sair não aparece na interface dos serviços do Google Play Games.

    3. Verifique se é possível recuperar o ID do jogador e, se aplicável, se os recursos do lado do servidor funcionam conforme o esperado.

    4. Se o jogo usar a autenticação do lado do servidor, teste minuciosamente o fluxo de requestServerSideAccess. Verifique se o servidor recebe o código de autenticação e pode trocá-lo por um token de acesso. Teste cenários de sucesso e falha para erros de rede e cenários de client ID inválidos.

Se o jogo usava algum dos recursos a seguir, teste-os para garantir que funcionem da mesma forma que antes da migração:

  • Placares: envie pontuações e veja os placares. Verifique se a classificação e a exibição dos nomes e pontuações dos jogadores estão corretas.
  • Conquistas: desbloqueie conquistas e verifique se elas são registradas e exibidas corretamente na interface do Play Games.
  • Jogos salvos: se o jogo usa jogos salvos, verifique se o salvamento e o carregamento do progresso funcionam perfeitamente. Isso é especialmente importante para testes em vários dispositivos e após atualizações do app.