O SDK do Google Play Games Services, games v1, depende do login do Google para Android, que foi
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 recurso de login do Google
causa problemas de dependência para apps de jogos existentes. A migração de apps
de jogos atuais do SDK
v1
para o SDK v2
resolve problemas de dependência introduzidos pela remoção do login do Google.
Este documento ajuda 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 v1 e v2 dos serviços relacionados a jogos do Google Play.
Interações com o SDK
Os diagramas ilustram a interação entre um aplicativo de jogos no Android, o núcleo dos Serviços do Google Mobile (GMS), os serviços do Google Play Games e um servidor de jogos de terceiros. Ele destaca como o aplicativo usa os serviços do Google para autenticação e recursos de jogo, 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.
- Ela 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 Auth. O SDK de autenticação do Google Play Services é responsável por processar os fluxos de autenticação e autorização do usuário na versão 1 dos jogos.
- Ambos os SDKs se comunicam usando a linguagem de definição de interface do Android (AIDL, na sigla em inglês), o que indica um padrão de comunicação entre diferentes processos ou serviços.
- A GMS Core também é chamada de Google Play Services.
- Essa é a camada exclusiva do Google no Android.
- O aplicativo de jogos usa dois módulos da GMS Core:
- Módulo de jogos: fornece 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 de jogos e de autenticação no aplicativo de jogos se comunicam com os módulos correspondentes usando interfaces AIDL, indicando a 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 do Play Games Services.
- 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 do jogo, gerenciar contas de usuário e facilitar os recursos multiplayer.
- Gateway de jogos de terceiros.
- Se o aplicativo de jogos se qualificar como um aplicativo de terceiros, 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 ser autenticado com um provedor de serviço diferente.
- Servidor de jogos de terceiros.
- Representa um servidor externo opcional com o qual 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 mostra uma comparação de recursos entre os SDKs v1 e v2 dos jogos:
Recurso |
SDK v1 do Play Games |
SDK do Play Games v2 |
|---|---|---|
Autenticação |
Integração com play-services-auth é necessária. |
Simplificado e simplificado, 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 adicionais do OAuth 2.0 com GoogleSigninClient.Código adicional para tratamento de erros durante o login. |
Não são permitidos outros escopos. Código adicional com um callback de falha de sucesso com serverAuthcode. |
Processo de login |
Uso de GoogleSigninClient.Código adicional para lidar com o código padrão de login automático e tratamento de erros. |
Uso de GamesSignInClient.O SDK processa o código boilerplate, o login automático e o tratamento de erros. |
Pop-up de boas-vindas |
É necessário um código extra. Os desenvolvedores podem controlar a posição e o momento. |
Nenhum código extra é necessário Interface do usuário consistente em todos os jogos configurados do PGS V2. . |
Dependências |
Exige play-services-auth. |
Não há dependência separada de play-services-auth. |
| Sair |
Uso de GoogleSignInClient.signOut. |
A API de desativação não é compatível. |
Várias contas dos serviços relacionados a jogos do Google Play e configurações por jogo |
A seleção e o gerenciamento de contas não estão disponíveis. |
Você pode gerenciar sua conta dos serviços relacionados a jogos do Google Play para cada jogo. Assim, você pode selecionar qual conta cada jogo usa. |