Visão geral da migração

O games v1 SDK dos serviços do Google Play Games depende do Login do Google para Android, que está descontinuado e será removido do SDK de autenticação do Google Play Services (com.google.android.gms:play-services-auth) em 2025. Novos apps de jogos podem usar o games v1 até 2025. A remoção do Login do Google causa problemas de dependência para apps de jogos atuais. Migrar apps de jogos do games v1 SDK para o games v2 SDK resolve problemas de dependência introduzidos pela remoção do Login do Google.

A migração dos serviços do Google Play Games v1 para v2 é uma atualização significativa que simplifica o desenvolvimento e oferece suporte a jogos multiplataforma. A v2 dos serviços do Google Play Games separa a plataforma e a identidade no jogo, atuando como um sistema de identidade no nível da plataforma que autentica automaticamente os jogadores no lançamento. A identidade da plataforma agora está separada do sistema principal de contas no jogo, que você precisa gerenciar de forma independente usando ferramentas como o Login do Google ou back-ends proprietários. A integração do SDK dos serviços do Google Play Games v2 usa o ID do jogador para recursos da plataforma, como conquistas e placares, sem alterar os fluxos de integração ou login atuais.

Este documento ajuda você a entender as interações entre o aplicativo de jogos e vários SDKs. Devido ao cronograma oficial de descontinuação, siga os princípios arquitetônicos, os caminhos e as estratégias de comunicação com os jogadores deste guia de migração para garantir a continuidade dos jogadores.

Interações do SDK

Os diagramas ilustram a interação entre um aplicativo de jogos no Android, o GMS Core, os serviços relacionados a jogos do Google Play e um servidor de jogos de terceiros (3P). Ele destaca como o aplicativo usa os serviços do Google para autenticação e recursos de jogos, além de interagir com um sistema externo.

Confira a seguir uma breve visão geral dos componentes e SDKs:

• Aplicativo de jogos.
  • Isso representa o aplicativo de jogo do usuário em execução em um dispositivo Android.
  • Ele contém dois componentes principais:
    • games v1 SDK ou games v2 SDK. O SDK do lado do cliente responsável por interagir com os serviços relacionados a jogos do Google Play.
    • SDK de autenticação. O SDK de autenticação do Google Play Services é responsável por processar fluxos de autenticação e autorização de usuários no games v1.
  • Os dois SDKs se comunicam usando AIDL (Linguagem de definição de interface do Android), indicando um padrão de comunicação entre diferentes processos ou serviços.
• O GMS Core também é chamado de Google Play Services.
  • Essa é a camada proprietária do Google no Android.
  • O aplicativo de jogos usa dois módulos do GMS Core:
    • O módulo de jogos oferece recursos específicos para jogos, como placares, conquistas e gerenciamento de estado do jogo.
    • Módulo de autenticação. Processa operações de autenticação e autorização do usuário.
  • Os SDKs games e auth no aplicativo de jogos se comunicam com os módulos correspondentes usando interfaces AIDL, indicando comunicação entre processos (IPC).

• Gateway dos serviços do Google Play Games.
  • Um gateway lógico que faz a mediação entre o GMS Core e o servidor dos serviços relacionados a jogos do Google Play.
  • Processa solicitações de API, transformação de dados e autenticação para a comunicação do servidor.
• Servidor dos serviços do Google Play Games.
  • Representa os serviços de back-end dos serviços relacionados a jogos do Google Play responsáveis por armazenar dados de jogos, gerenciar contas de usuários e facilitar recursos multiplayer.
• Portal de jogos de terceiros.
  • Se o aplicativo de jogos se qualificar como um aplicativo de terceiros (3P), a biblioteca de cliente vai se comunicar com os servidores dos serviços relacionados a jogos do Google Play pelos servidores externos.
  • Implica que o aplicativo também pode fazer a autenticação com outro provedor de serviços.
• Servidor de jogos de terceiros.
  • Representa um servidor externo opcional com que o aplicativo de jogos pode interagir, provavelmente para recursos personalizados ou gerenciamento de dados.
  • A comunicação com o aplicativo ocorre pelo gateway de jogos de terceiros.

Por que migrar seu título para os serviços do Google Play Games v2

A transição dos serviços do Google Play Games v1 para v2 é uma grande modernização arquitetônica que simplifica o desenvolvimento e oferece suporte a jogos multiplataforma.

Ao contrário da v1, que servia como um sistema principal de identidade no jogo, a v2 dos serviços relacionados a jogos do Google Play separa a plataforma e a identidade no jogo. Ele funciona como um sistema de identidade no nível da plataforma que autentica automaticamente os jogadores no lançamento para gerenciar recursos como conquistas e placares.

Agora você precisa gerenciar o sistema principal de contas no jogo de forma independente usando ferramentas como o Login do Google ou back-ends proprietários. O SDK dos serviços relacionados a jogos do Google Play v2 permite que os jogos usem o ID do jogador dos serviços relacionados a jogos do Google Play para acessar recursos da plataforma sem mudar os fluxos de integração ou login atuais. Este documento orienta você na migração, abordando princípios arquitetônicos, caminhos e estratégias de comunicação com os jogadores. A adesão é fundamental para a continuidade dos jogadores devido ao cronograma oficial de descontinuação.

Comparar a autenticação da plataforma e a autenticação no jogo

Nos serviços do Google Play Games v2, o conceito de "fazer login" é separado em duas camadas distintas:

• Identidade da plataforma.O SDK processa a autenticação da plataforma.
• Identidade no jogo.

Autenticação da plataforma

Os serviços do Google Play Games funcionam estritamente como uma camada de engajamento da plataforma. Ele gerencia o relacionamento do jogador com o ecossistema do Google Play Games (conquistas, rankings e eventos), em vez de autenticar uma conta ou um inventário de jogo específico.

• Silenciosa e automática:a autenticação acontece automaticamente em segundo plano quando o jogo é iniciado. Não há um botão manual "Fazer login" necessário para os serviços do Google Play Games.
• O ID do jogador:após a autenticação bem-sucedida 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, mas deve ser usado principalmente para rastrear estatísticas da plataforma (como o progresso das conquistas).
• Desacoplado:os serviços do Google Play Games v2 não podem ser usados como o sistema de identidade principal do jogo para gerenciar a conta do jogador no jogo com o progresso ou inventário dele. Os serviços do Google Play Games v2 atuam estritamente como um identificador de plataforma secundário e persistente.

Autenticação no jogo

Os desenvolvedores são responsáveis por gerenciar a "Conta no jogo" (IGA, na sigla em inglês). É o sistema de identidade que vincula o progresso, o inventário e a moeda de um jogador no jogo.

• Identidade principal:você pode 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:um jogador pode fazer login nos serviços do Google Play Games (identidade da plataforma) para ganhar conquistas enquanto está conectado a qualquer conta específica no jogo. Por exemplo, uma conta de visitante ou uma conta específica do SiWG.
• Gerenciamento de várias contas no jogo:os serviços do Google Play Games são responsáveis apenas pela autenticação da plataforma. O jogo gerencia a autenticação principal dos jogadores nas contas no jogo (IGAs, na sigla em inglês). Isso significa que não haverá mudanças nos fluxos atuais do jogo sobre como os jogadores alternam entre as contas no jogo. Enquanto isso acontece, eles permanecem autenticados na plataforma do Play Games usando os serviços do Google Play Games, e você continua enviando os dados relacionados a conquistas e outros recursos dos serviços do Google Play Games com o ID do jogador persistente.

Requisito de migração: vincule contas no jogo com o Open ID do Google em vez do ID de jogador dos serviços relacionados a jogos do Google Play

Na v1 dos serviços do Google Play Games, os desenvolvedores usavam esses serviços como o principal provedor de identidade. Um botão "Google Play" vincularia a conta no jogo (IGA, na sigla em inglês) de um jogador diretamente à Player ID dele.

Os serviços do Google Play Games v2 mudam isso ao fornecer autenticação de plataforma automática e silenciosa no lançamento. O Player ID resultante agora é usado exclusivamente para recursos da plataforma, como placares e conquistas, separado do login da conta principal.

Agora, os jogos precisam gerenciar a identidade principal de forma independente em uma tela de login dedicada que oferece métodos como "Fazer login com o Google" (SiWG) ou outras contas sociais. É importante lembrar que os serviços do Google Play Games v2 não podem ser usados como um sistema de identidade principal.

Essa mudança arquitetônica exige uma mudança correspondente na forma como os desenvolvedores estruturam os dados da conta. A conta no jogo (IGA, na sigla em inglês) precisa ser dissociada da vinculação primária ao Player ID.

Em vez disso, o IGA precisa ser vinculado a um identificador principal e estável que seja independente dos serviços do Google Play Games. O identificador recomendado é o Open ID fornecido pelo fluxo Fazer login com o Google (SiWG, na sigla em inglês). Esse Open ID serve como a chave exclusiva e persistente da conta principal do jogador no seu sistema.

No entanto, a IGA ainda pode ser vinculada ao Player ID como uma vinculação secundária. Esse link secundário tem duas funções importantes:

1. Isso permite que o jogo continue rastreando e atualizando o progresso dos recursos do Play Games (conquistas etc.) associados a esse jogador específico.
2. Ele ativa a funcionalidade "Restauração sem problemas", permitindo que o jogo faça login automaticamente de um jogador na IGA usada mais recentemente apenas em um novo dispositivo ou após uma reinstalação.

Entender esse modelo de identidade dissociada é fundamental para desbloquear o caminho de migração técnica correto para seu jogo.

Comparação do recurso

Esta tabela compara os recursos do games v1 SDK e games v2 SDK:

Recurso	games v1 SDK	games v2 SDK
Autenticação	Integração com play-services-auth necessária.	Simplificado e otimizado; sem necessidade de play-services-auth.
Autorização	Código adicional para sucesso, falhas e novas tentativas.	Gerenciado pelo SDK
Token de acesso do servidor	Pode solicitar escopos do OAuth 2.0 adicionais com GoogleSigninClient. Código adicional para tratamento de erros durante a autenticação.	Pode solicitar três escopos básicos de identidade do OAuth 2.0 com GamesSignInClient ao solicitar acesso do lado do servidor às APIs da Web dos serviços relacionados a jogos do Google Play. Para mais informações, consulte Acesso do lado do servidor aos serviços do Google Play Games e Recuperar códigos de autenticação do servidor.
Processo de login	Usa GoogleSigninClient. Código adicional para processamento de código boilerplate para autenticação automática e tratamento de erros.	Usa GamesSignInClient. O SDK processa código boilerplate, autenticação automática e tratamento de erros. O "fazer login" é separado em duas camadas distintas: Autenticação da plataforma: processada pelo SDK dos serviços do Google Play Games v2. Autenticação no jogo: processada pelo jogo.
Welcome Popup	Requer um código adicional. Os desenvolvedores podem controlar o posicionamento e o tempo.	Não requer código adicional. Interface do usuário consistente em todos os jogos configurados com o games v2 SDK.
Dependências	Exige play-services-auth.	O módulo Games cuida da autorização e da autenticação. Não é necessário adicionar outras dependências.
Sair	Usa GoogleSignInClient.signOut.	A API de encerramento de sessão não é necessária porque os Serviços do Google Play Games v2 são uma identidade de plataforma persistente.
Várias contas dos Serviços do Google Play Games e configurações por jogo	É possível gerenciar a conta no jogo.	Os usuários podem mudar o perfil dos serviços relacionados a jogos do Google Play nas configurações do dispositivo móvel. Para mais informações, consulte o artigo Como trocar de perfil do Play Games em dispositivos móveis.