Descripción general de la migración

La versión 1 del SDK de Servicios de Google Play Games 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 juegos hasta 2025. La eliminación del Acceso con Google introduce problemas de dependencia para las apps de juegos existentes. La migración de las apps de juegos existentes de la versión 1 del SDK de juegos a la versión 2 del SDK de juegos resuelve los problemas de dependencia que introduce la eliminación del Acceso con Google.

En este documento, se 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 las versiones 1 y 2 del SDK de los Servicios de Play Games.

Interacciones del SDK

En los diagramas, se ilustra la interacción entre una aplicación de juegos en Android, GMS Core, los Servicios de Play Games y un servidor de juegos externo (3P). Se destaca cómo la aplicación usa los servicios de Google para la autenticación y las funciones de juegos, mientras que también interactúa con un sistema externo independiente.

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 juegos del usuario que se ejecuta en un dispositivo con tecnología Android.
  • Contiene dos componentes principales:
    • Versión 1 o 2 del SDK de juegos. El SDK del cliente es responsable de interactuar con los Servicios de Play Games.
    • SDK de Auth. El SDK de Auth de Servicios de Google Play es responsable de controlar los flujos de autenticación y autorización de los usuarios en la versión 1 de juegos.
  • Ambos SDKs se comunican mediante 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 llama Servicios de Google Play.
  • Es la capa patentada 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 Auth. Controla las operaciones de autenticación y autorización de los usuarios.
  • Los SDKs de juegos y Auth en la aplicación de juegos se comunican con los módulos correspondientes mediante interfaces AIDL, lo que indica comunicación entre procesos (IPC).

• Puerta de enlace de los Servicios de Play Games.
  • Es una puerta de enlace lógica que media la comunicación entre GMS Core y el servidor de los Servicios de Play Games.
  • Controla las solicitudes a la API, la transformación de datos y la autenticación para la comunicación del servidor.
• Servidor de Servicios de Play Games.
  • Representa los servicios de backend de los Servicios de Play Games responsables de almacenar datos de juegos, administrar cuentas de usuario y facilitar funciones multijugador.
• Puerta de enlace de juegos externos.
  • Si tu aplicación de juegos califica como una aplicación externa (3P), la biblioteca cliente se comunica con los servidores de los Servicios de Play Games a través de los servidores de juegos externos.
  • Implica que la aplicación también puede autenticarse con un proveedor de servicios diferente.
• Servidor de juegos externos.
  • 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 produce a través de la puerta de enlace de juegos externos.

Comparación de funciones

En esta tabla, se compara la versión 1 y la versión 2 del SDK de juegos:

Función	Versión 1 del SDK de juegos	Versión 2 del SDK de juegos
Autenticación	Se requiere la integración con play-services-auth.	Es más simple y optimizado; no se requiere play-services-auth.
Autorización	Código adicional para éxito, fallas y reintentos.	Administrado por el SDK
Token de acceso del servidor	Puede solicitar permisos adicionales de OAuth 2.0 con GoogleSigninClient. Código adicional para el manejo de errores durante la autenticación.	Puede solicitar tres permisos de identidad básicos de OAuth 2.0 con GamesSignInClient cuando solicite acceso del servidor a las APIs web de los Servicios de Play Games. Para obtener más información, consulta Acceso del servidor a los Servicios de Play Games y Recupera códigos de autenticación del servidor.
Proceso de acceso	Usa GoogleSigninClient. Código adicional para el manejo de código estándar para la autenticación automática y el manejo de errores.	Usa GamesSignInClient. El SDK controla el código estándar, la autenticación automática y el control de errores.
Ventana emergente de bienvenida	Se requiere código adicional. Los desarrolladores pueden controlar su ubicación y tiempo.	No se requiere código adicional. Interfaz de usuario coherente en todos los juegos configurados con la versión 2 del SDK de juegos.
Dependencias	Requiere play-services-auth.	El módulo de juegos se encarga de la autorización y la autenticación. No es necesario agregar dependencias adicionales.
Cerrar sesión	Usa GoogleSignInClient.signOut.	No se admite la API de cierre de sesión.
Varias cuentas de Servicios de Play Games y configuración por juego	Es posible administrar cuentas dentro del juego.	Los usuarios pueden cambiar el perfil de los Servicios de Play Games en la configuración del dispositivo móvil. Para obtener más información, consulta cómo cambiar perfiles de Play Juegos en dispositivos móviles.