El primer paso para integrar tu juego con los Servicios de juego de Google Play (PGS) es implementar la autenticación de la plataforma. Esto es necesario para acceder a todas las demás funciones, como logros, tablas de clasificación y eventos.
Dado que el SDK de los Servicios de juego de Play realiza automáticamente la autenticación de la plataforma en el inicio del juego, debes integrar el SDK de PGS v2 en tu juego y, luego, implementar el flujo de autenticación recomendado para que tu juego esté listo para implementar y satisfacer los lineamientos de experiencia del usuario de Google Play Juegos Level Up.
Conceptos de autenticación
En los Servicios de juego de Play v2, el concepto de "acceso" se separa en dos capas distintas: autenticación de la plataforma y autenticación en el juego.
Autenticación de la plataforma
Los Servicios de juego de Play proporcionan una capa de participación en la plataforma. Administra la relación del jugador con el ecosistema de Google Play Juegos a través del perfil de gamer para acceder a funciones como logros, tablas de clasificación y misiones. La autenticación de la plataforma tiene las siguientes características clave:
- Silenciosa y automática: La autenticación se produce automáticamente en segundo plano cuando se inicia el juego. Los Servicios de juego de Play no requieren un botón manual de Acceder.
- ID de jugador: Después de una autenticación de plataforma exitosa, los Servicios de juego de Play proporcionan un ID de jugador estable. Este ID es coherente en todos los dispositivos para el mismo juego. Se usa principalmente para hacer un seguimiento de las funciones de la plataforma, como el progreso de los logros.
- Desvinculado: No debes usar los Servicios de juego de Play como el sistema de identidad principal de tu juego para administrar la cuenta del juego (IGA), el progreso o el inventario del jugador. Los Servicios de juego de Play actúan como un identificador de plataforma persistente.
ID de jugador
Un ID de jugador es un identificador para una cuenta de jugador de los Servicios de juego de Play. Tu juego puede recuperar un ID de jugador para cualquier usuario que acceda el juego con la autenticación de los Servicios de juego de Play. Tu integración del cliente del juego, la integración del servidor de juegos y el servicio de almacenamiento en la nube pueden usar el ID para acceder de forma segura a los datos del jugador desde los Servicios de juego de Play.
Un ID de jugador es coherente para un usuario cuando juega tu juego en varios dispositivos. Sin embargo, no siempre es coherente entre los juegos. Para obtener más información, consulta IDs de jugador de nueva generación.
Autenticación en el juego
Administras la cuenta en el juego (IGA), que es el sistema de identidad que vincula el progreso, el inventario y la moneda del jugador dentro del juego.
- Identidad principal: Puedes usar tu propio backend, Acceder con Google (SiWG) o cualquier otro proveedor como método de acceso principal.
- Independencia: Los jugadores pueden acceder a los Servicios de juego de Play (identidad de la plataforma) para obtener logros mientras acceden a cualquier IGA específico (por ejemplo, una cuenta de invitado o una cuenta de SiWG específica).
- Administración de varias IGAs: Los Servicios de juego de Play solo controlan la autenticación de la plataforma. Tu juego administra la autenticación principal de los jugadores en sus IGA. Esto significa que no habrá cambios en los flujos existentes de tu juego para que los jugadores cambien entre sus IGA. Cuando los jugadores cambian de cuenta, siguen autenticados en la plataforma de Play Juegos a través de los PGS, y tú sigues enviando sus datos relacionados con los logros y otras funciones de los PGS en función del ID de jugador persistente.
Continuidad multiplataforma con SiWG
Para ayudar a los jugadores a mantener su progreso en Android, iOS y la Web, usa el Acceso con Google como método principal de autenticación en el juego. Ten en cuenta lo siguiente:
- Botón de acceso con Google: En PGS v1, el botón Google Play solía controlar el acceso a la plataforma y al juego. En la versión 2, estos son procesos separados. Implementa un botón estándar de Acceder con Google para que los jugadores se autentiquen y accedan a su IGA.
- SDKs de acceso con Google:
- Tanto para Android como para iOS, usa los SDKs estándar de Acceso con Google para autenticar a los jugadores en sus IGA.
- Usar el OpenID de Google como identificador principal de la cuenta del jugador en el juego
- Usa el ID de jugador de los Servicios de juego de Play para informar el progreso de un jugador en las funciones de Play Juegos, como los logros.
Integración recomendada
Para integrar tu juego con los Servicios de juego de Play, sigue estos pasos recomendados:
Inicialización y autenticación
Este paso es obligatorio para inicializar y autenticar tu juego:
Implementa la autenticación de la plataforma inicializando el SDK de los Servicios de juego de Play v2 durante el inicio. Para obtener más información, consulta la autenticación de la plataforma para juegos de Android. Este paso es obligatorio para acceder a las funciones de los Servicios de juego de Play, como los logros y las tablas de clasificación.
La autenticación se ejecuta como un proceso silencioso en segundo plano durante el inicio del juego. Los usuarios existentes de los Servicios de juego de Play verán un mensaje de bienvenida después de la autenticación correcta. A los usuarios que no tienen un perfil de los Servicios de juego de Play se les solicita que creen uno durante la inicialización del SDK.
Creación de perfiles
Los jugadores necesitan un perfil de Servicios de juego de Play para interactuar con la plataforma. Es posible que algunos jugadores no tengan un perfil de los Servicios de juego de Play cuando comiencen a jugar tu juego. A estos jugadores se les pedirá que creen uno.
De forma predeterminada, las indicaciones para crear un perfil que se activan automáticamente aparecen cuando inicias un juego sin un perfil de los Servicios de juego de Play.
Autenticación en el juego
Una vez que se haya ejecutado correctamente la autenticación de la plataforma, los desarrolladores deben implementar los siguientes pasos para que los jugadores accedan a sus IGA, según el estado actual del juego:
- Si existe una sesión de juego activa en el dispositivo, permite que el jugador reanude su sesión actual.
- Si no hay una sesión de juego activa, sucede lo siguiente:
- En el caso de un escenario de restablecimiento sin problemas en el que se asocia un IGA de último juego con el ID de jugador de PGS, procede a restablecer automáticamente el IGA asociado.
- De lo contrario, muéstrale al jugador la pantalla de acceso o de creación de cuenta designada de tu aplicación. Luego, los jugadores pueden elegir su método de autenticación preferido para establecer o acceder a una IGA existente.
Permisos de OAuth
Los Servicios de juego de Play se basan en el sistema OAuth para permitir que los jugadores otorguen al juego acceso a su cuenta. Los Servicios de juego de Play tienen un permiso único para los juegos (games-lite) y dependen de otro (drive.appdata) si tu juego usa la función de juegos guardados. La función de juegos guardados brinda acceso a la cuenta de Google Drive del usuario, que es donde se almacenan los datos del juego.
Cuando usas la versión 2 del SDK de los Servicios de juego de Play, puedes solicitar permisos de OAuth adicionales.
Si necesitas permisos de OAuth adicionales, te recomendamos que llames a requestServerSideAccess.
Para obtener más información, consulta cómo obtener el código de autorización del servidor o cómo recuperar códigos de autenticación del servidor.
Lineamiento de la experiencia del usuario para el flujo de autenticación ideal
En los siguientes lineamientos, se explica el flujo de autenticación recomendado con la integración de PGS v2. Abarcan situaciones para usuarios nuevos, existentes y recurrentes, y el modo de invitado.
Jugador nuevo
Este flujo se aplica a un usuario que inicia el juego por primera vez en un dispositivo sin historial de juego previo.
- Cuando se inicia, el SDK de los PGS se inicializa para autenticar la identidad de la plataforma del usuario (ID de jugador de los PGS).
- Después de este intercambio en segundo plano, el juego muestra al jugador opciones para crear una IGA, por ejemplo, Crear una cuenta nueva, Acceder con Google o cualquier otro método de acceso con redes sociales.
- Una vez que el jugador crea o selecciona una IGA, el juego vincula esta cuenta al identificador principal elegido en su backend.
- El juego también vincula este IGA elegido al ID de jugador de los PGS, lo que lo marca como el IGA jugado por última vez para la restauración sin problemas.
Jugadores con sesiones activas
En esta situación, se describe a los jugadores que inician el juego en un dispositivo en el que ya tienen una sesión activa. El objetivo es brindar una experiencia de entrada fluida.
- Cuando el jugador inicia la app, los PGS se autentican de forma silenciosa en segundo plano y te proporcionan el ID de jugador para hacer un seguimiento del progreso en relación con los logros y otras funciones de Play Juegos.
- Simultáneamente, cuando corresponda, el juego omite las pantallas de acceso y hace que el jugador ingrese de inmediato a su sesión activa de IGA o a la IGA que se jugó por última vez y que está asociada a su ID de jugador, para que pueda reanudar el juego de inmediato.
Jugadores que cambian de cuenta
Este flujo se produce cuando un jugador con una sesión activa navega a la configuración del juego para cambiar de cuenta. Por ejemplo, salir de una cuenta principal para usar una cuenta alternativa.
- El jugador cierra la sesión de la IGA actual, pero la conexión de la plataforma de PGS permanece activa.
- Cuando el jugador accede con un IGA diferente, el juego vincula esta nueva cuenta al ID de jugador de los PGS actual como el IGA jugado más recientemente solo para una restauración sin problemas.
Restablecimiento sin interrupciones para los jugadores que vuelven
Este caso se aplica cuando un jugador inicia el juego después de un período de inactividad, una reinstalación o en un dispositivo completamente nuevo. Se recomienda que el juego implemente la restauración sin interrupciones.
- Cuando se inicia, los PGS autentican al usuario y proporcionan el ID de jugador de los PGS al juego.
- El juego verifica su backend (o el token de recuperación recuperado si usa la API de Recall) para ver si ya hay un IGA jugado recientemente vinculado a este ID de los PGS.
- Si se encuentra un vínculo, el juego restablece automáticamente el progreso del jugador y lo accede, lo que omite por completo la pantalla de acceso manual.
- De lo contrario, el juego le muestra al jugador la pantalla de acceso.
- Luego, el jugador elige un método de acceso y accede a un IGA.
- Luego, el juego vincula este IGA con el ID de jugador de los PGS como el último IGA reproducido para una restauración perfecta.
Modo de invitado
Los jugadores pueden iniciar el juego y jugar con una cuenta de invitado local. PGS aún se autentica en segundo plano. Si el jugador elige Guardar progreso, el juego convierte la sesión de invitado en un IGA permanente y lo vincula al ID de jugador de los PGS.
