Restauração simplificada

A Restauração sem problemas é um recurso dos serviços do Google Play Games projetado para reconectar imediatamente os jogadores que retornam ao progresso do jogo quando eles instalam ou reinstalam um jogo em um novo dispositivo, removendo a dificuldade de uma tela de login.

A restauração sem problemas é uma diretriz recomendada para o programa Level Up.

Use a autenticação dos serviços do Google Play Games para simplificar a experiência de autenticação da plataforma do usuário no seu jogo. Inicialize o SDK dos serviços do Google Play Games para acionar a autenticação, o que elimina a necessidade de um fluxo de autenticação de plataforma separado.

Vincular contas de usuário para ativar a continuidade e o Play entre dispositivos

Os jogadores interagem com os jogos favoritos em vários dispositivos e plataformas, incluindo dispositivos móveis, tablets e PCs. Uma expectativa principal desses jogadores é a capacidade de retomar o jogo exatamente de onde pararam, independente do dispositivo escolhido.

Uma barreira significativa que geralmente leva ao abandono do usuário é a necessidade de fazer login separadamente em cada novo dispositivo. Os usuários precisam de imersão imediata na experiência do jogo, sem interrupções desnecessárias.

Para facilitar a continuidade e a reprodução entre dispositivos, é necessário implementar dois recursos principais:

Vinculação de contas
Cloud Save

O processo de autenticação dos serviços do Google Play Games oferece opções flexíveis para identificadores de jogadores. Essas opções permitem integrar os serviços do Google Play Games à sua solução de identidade atual.

Nova integração dos serviços do Google Play Games

Para jogos sem integração com os serviços do Google Play Games, a API Recall simplifica a configuração do back-end gerenciando associações de contas e armazenando a conexão entre a conta de um usuário no jogo e a conta dele nos serviços do Google Play Games.

Vinculação de contas usando a API Recall

A API Recall é a solução recomendada para vincular contas de usuário em jogos multiplataforma. Essa API é particularmente útil para jogos sem integração com os serviços do Google Play Games ou que usam outras soluções de autenticação de plataforma além dos serviços do Google Play Games.

A API Recall simplifica a configuração do back-end do jogo gerenciando associações de contas.

Back-end simplificado:a API simplifica a configuração do back-end do jogo para vinculação de contas.
Associações gerenciadas pelo Google Play:o Google Play armazena a associação entre as contas de jogos dos usuários (incluindo contas de terceiros) e as contas dos serviços do Google Play Games.
Restauração de progresso:os desenvolvedores geram e enviam tokens de recall para o Google Play, que podem ser recuperados para restaurar o progresso de um jogo do usuário.

Ao implementar a API Recall, os desenvolvedores precisam verificar se os tokens de recall são strings opacas. Esses tokens não podem ter dados sensíveis ou informações de identificação pessoal (como nome, endereço de e-mail ou dados demográficos) sobre os jogadores.

Os jogos precisam usar algoritmos de criptografia robustos ao gerar tokens de recuperação para proteger os dados do usuário e manter a segurança.

Para saber mais sobre como a API Recall funciona, consulte API Recall.

Para implementar o recurso da API Recall, consulte Integrar a API Recall dos serviços do Google Play Games ao jogo.

Integração atual dos serviços do Google Play Games

Esta seção explica como integrar seu jogo aos serviços do Google Play Games vinculando contas de jogadores. Saiba como usar IDs de jogador para identificar jogadores autenticados e gerenciar várias contas de jogos para um único usuário dos serviços do Google Play Games.

Vincular com um `Player_id`

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 autenticado usando os serviços do Google Play Games.

Os jogos que têm o back-end configurado com os serviços do Google Play Games Player_Id ou que exigem suporte para usuários menores de idade precisam usar Player_Id e vincular o jogo e as contas de terceiros com Player_Id.

Entenda como os IDs de jogador funcionam:

Consistência em um jogo:um ID de jogador permanece consistente para um usuário em vários dispositivos quando ele joga o mesmo jogo.
Inconsistência entre jogos:os IDs de jogador nem sempre são consistentes quando um usuário joga jogos diferentes.

Para mais informações, consulte IDs de jogadores de última geração.

Gerenciar várias contas por usuário com vinculação

Para vincular várias contas de usuário a uma única conta dos serviços do Google Play Games, crie um mapeamento de um para muitos na sua tabela.

Identidade do Google multiplataforma usando o recurso Fazer login com o Google

O Fazer login com o Google (SiwG, na sigla em inglês) é a principal solução de identidade do Google que permite que os desenvolvedores de jogos recebam com segurança as informações de perfil dos jogadores: nome, endereço de e-mail e foto do perfil.

Um dos principais benefícios do Fazer login com o Google é a ampla disponibilidade em várias plataformas, incluindo Web, Android e iOS. Ele oferece uma experiência de login rápida, segura e familiar que os jogadores já conhecem e em que confiam.

Vincular com o campo `sub` do token de ID do Google

Para criar uma experiência multiplataforma integrada, implemente uma estratégia de autenticação que vincule o sistema de contas do jogo a um identificador exclusivo da Conta do Google. Essa abordagem aproveita a autenticação simplificada dos serviços do Google Play Games no Android e usa o SDK padrão Fazer login com o Google em outras plataformas, como iOS e Web.

O campo sub do token de ID do Google é um identificador exclusivo e persistente da conta de um usuário do Google. Esse campo sub é idêntico em todas as plataformas para o mesmo usuário. Use esse valor sub como a chave exclusiva no back-end para vincular e restaurar o progresso do jogador em vários dispositivos. Essa chave vincula todas as sessões de um jogador a uma única conta de jogo no seu back-end.

Confira o fluxo geral:

No Android:seu jogo inicializa o SDK dos serviços do Google Play Games para acionar a autenticação da plataforma automaticamente em dispositivos Android. Ao fazer login com o Google no Android, solicite os três escopos de login: email, profile e openid. Não use a integração dos serviços do Google Play Games v2. São os mesmos escopos que um SDK SiwG padrão solicita. Isso permite recuperar um token de ID que contém o campo sub do jogador.
Na Web e no iOS:seu jogo usa os SDKs padrão Fazer login com o Google na Web e Fazer login com o Google no iOS e no macOS. Quando o usuário faz login, o SDK SiwG fornece um token de ID que também contém o campo sub do usuário.
Vinculação de contas:como o usuário faz login com a mesma Conta do Google nas duas plataformas, o campo sub que você recebe é idêntico. Assim, você pode vincular esse valor sub ao ID de usuário interno na solução de identidade, criando uma experiência unificada para o usuário.

Integração no Android

No Android, inicialize o SDK dos serviços do Google Play Games para acionar a autenticação da plataforma automaticamente em dispositivos Android. Em seguida, ao fazer login com o Google no Android, solicite os três escopos de login: email, profile e openid. Isso permite recuperar um código de autenticação do lado do servidor, que o back-end pode trocar por um token de ID que contém as informações do usuário, incluindo o campo sub exclusivo.

Em geral, a implementação envolve:

Configurar IDs do cliente em um projeto unificado:antes da integração, você precisa configurar os serviços do Google Play Games no Google Play Console para receber seus IDs do cliente OAuth 2.0.

Importante: Para vinculação multiplataforma, esse projeto do Google Cloud precisa ser usado em todas as plataformas. Todos os IDs de cliente que você criar depois para outras plataformas (como Web e iOS) precisam ser adicionados a esse mesmo projeto.
Configurar os serviços do Google Play Games:primeiro, adicione seu jogo ao Google Play Console e integre a autenticação da plataforma dos serviços do Google Play Games ao seu jogo.
Adicione um botão "Fazer login com o Google":na página de login ou na tela de configurações do usuário do jogo, adicione um botão Fazer login com o Google. Esse botão vai acionar o fluxo de login ou inscrição. Ao criar esse botão, recomendamos que você siga as diretrizes de branding do Fazer login com o Google. No mínimo, o botão precisa mostrar claramente "Google" ou "Fazer login com o Google". O link das diretrizes também oferece recursos de UX para download que estão em conformidade e podem ser usados no seu jogo.
Solicitar o código de autenticação do servidor com escopos de login:quando o jogador clica no botão, o jogo solicita um código de autenticação do servidor único. A etapa mais importante é configurar essa solicitação para incluir os seguintes escopos de login: EMAIL, PROFILE e OPEN_ID.

A configuração depende do seu ambiente de desenvolvimento:
- Para Java/Kotlin:consulte o guia para receber o código de autenticação do servidor usando requestServerSideAccess.
- Para Unity:consulte o guia para recuperar códigos de autorização no Unity.
Trocar o código de autorização e verificar o token de ID no back-end:envie o código de autorização da etapa anterior ao servidor de back-end. No servidor, siga o guia do fluxo de troca de código OAuth 2.0 padrão para trocar o código por um token de ID, um token de acesso e um token de atualização. Conforme descrito no guia, você precisa verificar o token de ID no seu servidor.
Vincule o campo sub:depois que o token de ID for verificado, extraia o campo sub da carga útil. Use esse valor sub como a chave exclusiva da identidade do Google na sua solução de identidade.
- Se esse valor sub já existir no seu banco de dados, o usuário já fez a vinculação antes. Faça login na conta do jogo correspondente.
- Se esse valor de sub não existir, crie uma conta de usuário no sistema de contas do jogo associada a esse sub ou vincule a uma conta de usuário no sistema de contas correspondendo às informações do usuário (como o endereço de e-mail) fornecidas no token de ID.

Integração no iOS, na Web e em outras plataformas

Em plataformas diferentes de Android, iOS, Web ou PC, você vai usar os SDKs padrão do Fazer login com o Google. O objetivo é o mesmo do fluxo do Android: receber um token de ID do Google com segurança, enviá-lo ao back-end e usar o campo sub para vincular a conta.