Use a autenticação dos serviços relacionados a jogos do Google Play para simplificar a experiência de autenticação da plataforma do usuário no seu jogo. Inicialize o SDK dos serviços relacionados a jogos do Google Play 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 a reprodução 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 de 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
- Salvar na nuvem
O processo de autenticação dos serviços relacionados a jogos do Google Play oferece opções flexíveis para identificadores de jogadores. Essas opções permitem integrar os serviços relacionados a jogos do Google Play à sua solução de identidade atual.
Nova integração dos serviços relacionados a jogos do Google Play
Para jogos sem integração com os serviços relacionados a jogos do Google Play, 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 relacionados a jogos do Google Play.
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 relacionados a jogos do Google Play ou que usam outras soluções de autenticação de plataforma além dos serviços relacionados a jogos do Google Play.
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 relacionados a jogos do Google Play.
- Restauração de progresso:os desenvolvedores geram e enviam tokens de recuperação 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 relacionados a jogos do Google Play ao jogo.
Gerenciar várias contas com a API Recall
Ao gerenciar várias contas para o mesmo usuário, você pode tratar cada uma delas como uma persona distinta. Essa abordagem permite experiências personalizadas com base no contexto específico do usuário.
Para implementar essa abordagem, siga estas etapas:
- Gere um token exclusivo para cada persona. Consulte Configuração do cliente do jogo.
- Vincule esses tokens à conta dos Serviços do Google Play Jogos usando a API Recall. Consulte Armazenar tokens.
- Defina uma política de resolução para cenários em que uma conta dos serviços relacionados a jogos do Google Play está vinculada a várias personas. Consulte Último token de recall em todos os jogos de contas de desenvolvedor.
Embora várias opções de política estejam disponíveis (como restaurar automaticamente a última conta), recomendamos apresentar um comando ao usuário. Essa solicitação precisa pedir que eles selecionem a conta que querem restaurar, oferecendo uma experiência clara e fácil de usar.
Integração atual dos Serviços relacionados a jogos do Google Play
Esta seção explica como integrar seu jogo aos serviços relacionados a jogos do Google Play 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 relacionados a jogos do Google Play.
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 relacionados a jogos do Google Play.
Os jogos que têm o back-end configurado com os serviços relacionados a jogos do Google Play 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:
- Consistente 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 relacionados a jogos do Google Play, crie um mapeamento de um para muitos na sua tabela.
Identidade do Google multiplataforma usando o recurso Fazer login com o Google
O Login do 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 relacionados a jogos do Google Play no Android e usa o SDK padrão Fazer login com o Google em outras plataformas, como iOS e Web.
A chave dessa estratégia é o campo sub do token de ID do Google . O campo sub (ou "assunto") é um identificador exclusivo e persistente da conta de um usuário do Google. Você vai usar esse ID como a "ponte" para vincular 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 relacionados a jogos do Google Play
para acionar a autenticação automaticamente em dispositivos Android. Você
configura a integração dos serviços relacionados a jogos do Google Play v2 para solicitar os
três escopos de login:
email,profileeopenid. São os mesmos escopos que um SDK padrão de Login com o Google solicita. Isso permite recuperar um token de ID que contém o camposubdo 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 para iOS e macOS. Quando o usuário faz login, o SDK do SiwG fornece um token de ID que também
contém o campo
subdo usuário. - Vinculação de contas:como o usuário faz login com a mesma Conta do Google nas duas plataformas, o campo
subque você recebe é idêntico. Assim, você pode vincular esse valorsubao 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, você vai usar o SDK dos serviços relacionados a jogos do Google Play como o principal ponto de integração. A chave é configurar o cliente de login dos serviços relacionados a jogos do Google Play para solicitar
os escopos de login adicionais. Isso permite recuperar um código de autenticação do lado do servidor, que o back-end pode trocar por um token de ID contendo 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 relacionados a jogos do Google Play no Google Play Console para receber seus IDs do cliente OAuth 2.0.
Configure os serviços relacionados a jogos do Google Play:antes de começar, adicione seu jogo ao Google Play Console e integre a autenticação da plataforma dos serviços relacionados a jogos do Google Play ao 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 da promoção de marca do Login do 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.
Solicite o código de autenticação do servidor com escopos de login:quando o jogador clicar no botão, o jogo vai solicitar 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,PROFILEeOPEN_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 padrão de fluxo de troca de código OAuth 2.0 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 camposubda carga útil. Use esse valorsubcomo a chave exclusiva da identidade do Google na sua solução de identidade.Se esse valor de
subjá 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
subnão existir, crie uma conta de usuário no sistema de contas do jogo associada a essesubou 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 Google Sign-In. 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.
Em geral, a implementação envolve:
Integração do lado do cliente:siga a documentação oficial para integrar o SDK Fazer login com o Google na sua plataforma. Esses guias abordam o fluxo completo do lado do cliente, desde a renderização de um botão "Fazer login com o Google" até a recuperação do token de ID.
Para iOS:Login do Google para iOS e macOS
Para plataformas sem um SDK dedicado (como um mecanismo de jogo personalizado ou build de PC), é possível implementar manualmente o fluxo de servidor da Web OAuth 2.0 para receber os tokens necessários.
Lógica de back-end:envie o token de ID (ou código de autenticação) para o back-end. Em seguida, o servidor realiza a mesma verificação e lógica de vinculação do campo
subdescritas nas etapas 4 e 5 da seção "Integração no Android".
Como o campo sub de todos esses fluxos de Fazer login com o Google é idêntico ao recuperado do fluxo dos Serviços relacionados a jogos do Google Play no Android (para a mesma Conta do Google), esse processo vincula a conta do usuário em todas as plataformas.