Los Servicios de juego de Google, el SDK de juegos v1, dependen de Acceder con Google para Android, que dejó de estar disponible y se quitará del SDK de Auth de Servicios de Google Play (com.google.android.gms:play-services-auth) en 2025.
Las apps de juegos nuevas pueden usar la versión 1 de los juegos hasta 2025. La eliminación de Acceso con Google genera problemas de dependencia para las apps de juegos existentes. Migrar las apps de juegos existentes del SDK de juegos v1 al SDK de juegos v2 resuelve los problemas de dependencia que genera la eliminación de Acceso con Google.
Este documento te ayuda a comprender las interacciones entre la aplicación de juegos y varios SDKs. En este documento, también se comparan las funciones de la aplicación con las de los SDKs de la versión 1 y la versión 2 de los juegos de los Servicios de juego de Play.
Interacciones con el SDK
En los diagramas, se ilustra la interacción entre una aplicación de juegos en Android, el núcleo de los Servicios de Google para dispositivos móviles (GMS), los Servicios de juego de Play y un servidor de juegos de terceros. Destaca cómo la aplicación usa los servicios de Google para la autenticación y las funciones del juego, a la vez que interactúa con un sistema externo independiente.
games v2 (actual)
games v1 (heredado)
A continuación, se incluye una breve descripción general de los componentes y los SDKs:
- Aplicación de juegos.
- Representa la aplicación de juego del usuario que se ejecuta en un dispositivo con Android.
- Contiene dos componentes principales:
- SDK de juegos v1 o v2. El SDK del cliente responsable de interactuar con los Servicios de juego de Play
- SDK de Auth. El SDK de Auth de los Servicios de Google Play es responsable de controlar los flujos de autenticación y autorización del usuario en la versión 1 de los juegos.
- Ambos SDKs se comunican con AIDL (Lenguaje de definición de la interfaz de Android), lo que indica un patrón de comunicación entre diferentes procesos o servicios.
- GMS Core también se conoce como Servicios de Google Play.
- Esta es la capa de propiedad de Google en Android.
- La aplicación de juegos usa dos módulos de GMS Core:
- Módulo de juegos: Proporciona funciones específicas del juego, como tablas de clasificación, logros y administración del estado del juego.
- Módulo de autenticación. Controla las operaciones de autenticación y autorización de los usuarios.
- Los SDKs de Games y Auth en la aplicación de juegos se comunican con los módulos correspondientes a través de interfaces AIDL, lo que indica una comunicación entre procesos (IPC).
- Puerta de enlace de los Servicios de juego de Play.
- Una puerta de enlace lógica que media la comunicación entre GMS Core y el servidor de los Servicios de Play Juegos.
- Controla las solicitudes a la API, la transformación de datos y la autenticación para la comunicación del servidor.
- Servidor de los Servicios de juego de Play
- Representa los servicios de backend de los Servicios de juego de Play responsables de almacenar datos de juegos, gestionar cuentas de usuario y facilitar funciones multijugador.
- Puerta de enlace de juegos de terceros.
- Si tu aplicación de juegos califica como aplicación de terceros, la biblioteca cliente se comunica con los servidores de los Servicios de juego de Play a través de los servidores de juegos de terceros.
- Implica que la aplicación también puede autenticarse con un proveedor de servicios diferente.
- Servidor de juegos de terceros.
- Representa un servidor externo opcional con el que puede interactuar la aplicación de juegos, probablemente para funciones personalizadas o administración de datos.
- La comunicación con la aplicación se realiza a través de la puerta de enlace de juegos de terceros.
Comparación de funciones
En esta tabla, se muestra una comparación de funciones entre los SDKs de juegos de la versión 1 y de la versión 2:
Feature |
SDK de juegos v1 |
SDK de juegos v2 |
|---|---|---|
Autenticación |
Se requiere la integración con play-services-auth. |
Simplificado y optimizado, no se requiere play-services-auth. |
Autorización |
Código adicional para los casos de éxito, fallas y reintentos. |
Administrado por el SDK |
Token de acceso al servidor |
Puede solicitar permisos de OAuth 2.0 adicionales con GoogleSigninClient.Código adicional para el manejo de errores durante el acceso. |
No se permiten permisos adicionales. Código adicional con una devolución de llamada de error de éxito con serverAuthcode. |
Proceso de acceso |
Usa GoogleSigninClient.Código adicional para controlar el código de plantilla para el acceso automático y el manejo de errores. |
Usa GamesSignInClient.El SDK de controla el código de plantilla, el acceso automático y el manejo de errores. |
Ventana emergente de bienvenida |
Se requiere código adicional. Los desarrolladores pueden controlar su ubicación y el momento. |
No se requiere código adicional. Interfaz de usuario coherente en todos los juegos configurados de los PGS V2. . |
Dependencias |
Requiere play-services-auth. |
No hay una dependencia independiente en play-services-auth. |
| Salir |
Usa GoogleSignInClient.signOut. |
No se admite la API de Logout. |
Varias cuentas de los Servicios de juego de Play y configuración por juego |
La selección y administración de cuentas no está disponible. |
Para cada juego, puedes administrar tu cuenta de los Servicios de juego de Play. Esto te permite seleccionar la cuenta que usa cada juego. |