Visão geral da migração

O games v1 SDK dos serviços relacionados a jogos do Google Play 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. Os novos apps de jogos podem usar a v1 até 2025. A remoção do Login do Google introduz problemas de dependência aos apps de jogos. 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.

Este documento ajuda você a entender as interações entre o aplicativo de jogos e vários SDKs. Este documento também compara os recursos do aplicativo com os recursos do games v1 SDK e do games v2 SDK dos serviços relacionados a jogos do Google Play.

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 relacionados a jogos do Google Play.
  • 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 relacionados a jogos do Google Play.
  • 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.
• Gateway 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.

Comparação de recursos

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 OAuth 2.0 adicionais com GoogleSigninClient. Código adicional para tratamento de erros durante o login.	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 servidor aos serviços relacionados a jogos do Google Play e Recuperar códigos de autenticação do servidor.
Processo de login	Usa GoogleSigninClient. Código adicional para processamento de código boilerplate para login automático e tratamento de erros.	Usa GamesSignInClient. O SDK processa código boilerplate, login automático e tratamento de erros.
Pop-up de boas-vindas	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 saída não é compatível.
Várias contas dos serviços relacionados a jogos do Google Play 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.