Os serviços relacionados a jogos do Google Play, o SDK de jogos v1, dependem do Google Sign-In 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 Google Sign-In
introduz problemas de dependência para apps de jogos atuais. Migrar apps de jogos
existentes do SDK
de jogos v1
para o SDK de jogos v2
resolve problemas de dependência introduzidos pela remoção do Google Sign-In.
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 dos SDKs dos serviços relacionados a jogos do Google Play v1 e v2.
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 separado de terceiros.
games v2 (atual)
games v1 (legado)
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:
- SDK do Games v1 ou v2. 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 dos serviços do Google Play é responsável por processar fluxos de autenticação e autorização de usuários nos jogos v1.
- Os dois SDKs se comunicam usando AIDL (Android Interface Definition Language), 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 medeia a comunicação entre o GMS Core e o servidor dos Serviços do Google Play Jogos.
- 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 multijogador.
- 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 de jogos de terceiros.
- Implica que o aplicativo também pode autenticar com um provedor de serviços diferente.
- 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 dos SDKs de jogos v1 e v2:
Recurso |
SDK do Play Games v1 |
SDK do Play Games v2 |
|---|---|---|
Autenticação |
Integração com play-services-auth necessária. |
Simplificado e otimizado; não é necessário 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 padrão 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 |
É necessário um código adicional. Os desenvolvedores podem controlar o posicionamento e o tempo. |
Nenhum código adicional é necessário. Interface do usuário consistente em todos os jogos configurados com o SDK do Play Games v2. |
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 como trocar de perfil do Play Games em dispositivos móveis. |