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 lanzamiento del juego, debes integrar el SDK de los PGS v2 con tu juego y, luego, implementar el flujo de autenticación recomendado para que tu juego esté listo para implementar y satisfacer los lineamientos de la 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 divide 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 de la plataforma. Administra la relación del jugador con el ecosistema de Google Play Juegos mediante elperfil de jugador 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 Acceder manual.
- ID de jugador: Después de una autenticación de la 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. Usa este ID principalmente para hacer un seguimiento de las funciones de la plataforma, como el progreso de los logros.
- Desvinculada: No debes usar los Servicios de juego de Play como el sistema de identidad principal de tu juego para administrar la cuenta en el juego (IGA) del jugador, el progreso del juego o el inventario. Los Servicios de juego de Play funcionan 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. La integración del cliente de tu juego, 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ífica (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 IGAs. Esto significa que no hay cambios en los flujos existentes de tu juego para que los jugadores cambien entre sus IGAs. Cuando los jugadores cambian de cuenta, permanecen 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 llevar su progreso en Android, iOS y la Web, usa Acceder con Google como método de autenticación principal en el juego. Ten en cuenta lo siguiente:
- Botón Acceder con Google: En los PGS v1, el botón Google Play solía controlar el acceso a la plataforma y al juego. En la v2, estos son procesos separados. Implementa un botón Acceder con Google estándar 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 de Acceso con Google estándar para autenticar a los jugadores en sus IGAs.
- Usa Google Open ID como el identificador principal de la cuenta en el juego de un jugador.
- 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 necesario para inicializar y autenticar tu juego:
Implementa la autenticación de la plataforma inicializando el SDK de los Servicios de juego de Play v2 al inicio. Para obtener más información, consulta la autenticación de la plataforma para juegos de Android. Este paso es necesario 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 lanzamiento del juego. Los usuarios existentes de los Servicios de juego de Play ven un mensaje de bienvenida después de una autenticación exitosa. Se les solicita a los usuarios que no tienen un perfil de los Servicios de juego de Play que creen uno durante la inicialización del SDK.
Creación de perfiles
Los jugadores necesitan un perfil de los 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 inicien tu juego. Se les pedirá que creen uno.
Las indicaciones de creación de perfiles activadas automáticamente aparecen de forma predeterminada 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 IGAs, 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, haz lo siguiente:
- En el caso de una situación de restablecimiento sin interrupciones en la que una IGA jugada por última vez esté asociada con el ID de jugador de los PGS, continúa para restablecer automáticamente la IGA asociada.
- De lo contrario, presenta 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 una IGA existente o acceder a ella.
Alcances 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 autenticación del servidor o recuperar códigos de autenticación del servidor.
Lineamiento de la experiencia del usuario para un flujo de autenticación ideal
En los siguientes lineamientos, se explica el flujo de autenticación recomendado con la integración de los 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 anterior.
- Al iniciarse, 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 protocolo de enlace en segundo plano, el juego muestra al jugador opciones de creación de IGA a el jugador, por ejemplo, Crear cuenta nueva, Acceder con Google o cualquier otro método de acceso social.
- Una vez que el jugador crea o selecciona una IGA, el juego vincula esta cuenta a el identificador principal elegido en su backend.
- El juego también vincula esta IGA elegida al ID de jugador de los PGS, lo que la marca como la última IGA jugada para un restablecimiento sin interrupciones.
Jugadores con sesiones activas
En este caso, se describe a los jugadores que inician el juego en un dispositivo en el que ya tienen una sesión activa. El objetivo es proporcionar una experiencia de entrada sin interrupciones.
- 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.
- Al mismo tiempo, cuando corresponda, el juego omite las pantallas de acceso y accede inmediatamente al jugador a su sesión de IGA activa o a la IGA jugada por última vez asociada con 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, cerrar la sesión 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 los PGS permanece activa.
- Cuando el jugador accede con una IGA diferente, el juego vincula esta cuenta nueva al ID de jugador de los PGS actual como la IGA jugada por última vez solo para un restablecimiento sin interrupciones.
Restablecimiento sin interrupciones para jugadores recurrentes
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 el restablecimiento sin interrupciones.
- Al iniciarse, 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 una IGA jugada por última vez ya está vinculada a este ID de los PGS.
- Si se encuentra un vínculo, el juego restablece automáticamente el progreso del jugador y accede a él, omitiendo por completo la pantalla de acceso manual.
- De lo contrario, el juego le presenta al jugador su pantalla de acceso.
- Luego, el jugador elige un método de acceso y accede a una IGA.
- Luego, el juego vincula esta IGA con el ID de jugador de los PGS como la última IGA jugada para un restablecimiento sin interrupciones.
Modo de invitado
Los jugadores pueden iniciar el juego y jugar con una cuenta de invitado local. Los PGS aún se autentican en segundo plano. Si el jugador elige Guardar progreso, el juego convierte la sesión de invitado en una IGA permanente y la vincula al ID de jugador de los PGS.
