El SDK de Servicios de juego de Google Play, juegos v1, depende del Acceso 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 Games hasta el 2025. La eliminación del acceso con Google introduce problemas de dependencia para las apps de juegos existentes. Migrar las apps de juegos existentes del SDK de games v1 al SDK de games v2 resuelve los problemas de dependencia que se introdujeron con la eliminación del acceso con Google.
Este documento te ayuda a comprender las interacciones entre la aplicación de juegos y los distintos SDKs. En este documento, también se comparan las funciones de la aplicación con las de los SDK de los juegos de los Servicios de juego de Play v1 y v2.
Interacciones del SDK
En los diagramas, se ilustra la interacción entre una aplicación de juegos en Android, los Servicios de Google Mobile (GMS) Core, los Servicios de juego de Play y un servidor de juegos de terceros (3P). Se 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 games v1 o games v2 Es 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 los juegos v1.
- Ambos SDK se comunican a través de AIDL (Android Interface Definition Language), lo que indica un patrón de comunicación entre diferentes procesos o servicios.
- GMS Core, también llamado Servicios de Google Play.
- Esta es la capa patentada de Google en Android.
- La aplicación de juegos usa dos módulos de GMS Core:
- El módulo de juegos proporciona funciones específicas para juegos, 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 del usuario.
- Los SDKs de Juegos y de Auth en la aplicación de juegos se comunican con los módulos correspondientes a través de interfaces de AIDL, lo que indica comunicación entre procesos (IPC).
- Puerta de enlace de los Servicios de juego de Play.
- Es una puerta de enlace lógica que media la comunicación entre GMS Core y el servidor de Play Games Services.
- 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 Play Games Services responsables de almacenar datos del juego, administrar cuentas de usuario y facilitar las funciones multijugador.
- Puerta de enlace de juegos de terceros.
- Si tu aplicación de juegos cumple con los requisitos para ser una aplicación de terceros (3P), 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 se puede autenticar con otro proveedor de servicios.
- Servidor de juegos de terceros.
- Representa un servidor externo opcional con el que la aplicación de juegos puede interactuar, 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 comparan las funciones de los SDKs de games v1 y games v2:
Función |
SDK de games v1 |
SDK de games 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 éxitos, fallas y reintentos. |
Administrado por el SDK |
Token de acceso del servidor |
Puede solicitar permisos de OAuth 2.0 adicionales con GoogleSigninClient.Código adicional para el manejo de errores durante el acceso. |
Puede solicitar tres permisos de identidad básicos de OAuth 2.0 con GamesSignInClient cuando solicita acceso del servidor a las APIs web de Play Juegos.
Para obtener más información, consulta Acceso del servidor a los Servicios de juego de Play y Cómo recuperar códigos de autenticación del servidor. |
Proceso de acceso |
Usa GoogleSigninClient.Código adicional para el manejo de código estándar para el acceso automático y el manejo de errores. |
Usa GamesSignInClient.El SDK controla el código estándar, el acceso automático y el control de errores. |
Ventana emergente de bienvenida |
Se requiere código adicional. Los desarrolladores pueden controlar su ubicación y el momento en que se muestra. |
No se requiere código adicional. Interfaz de usuario coherente en todos los juegos configurados con el SDK de la versión 2 de games |
Dependencias |
Requiere play-services-auth. |
El módulo de Games se encarga de la autorización y la autenticación. No es necesario que agregues dependencias adicionales. |
| Cierre de sesión |
Usa GoogleSignInClient.signOut. |
No se admite la API de cierre de sesión. |
Varias cuentas de Servicios de juego de Play y configuración por juego |
Es posible administrar la cuenta dentro del juego. |
Los usuarios pueden cambiar el perfil de los Servicios de juego de Play en la configuración del dispositivo móvil. Para obtener más información, consulta cómo cambiar de perfil de Play Juegos en dispositivos móviles. |