Para integrar tu juego con los Servicios de juego de Google Play, primero implementa 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.
Para cumplir con los lineamientos sobre la experiencia del usuario de Level Up de Google Play Juegos, tu juego debe cumplir con el flujo de autenticación recomendado.
Inicialización y autenticación
Este es un paso obligatorio para inicializar y autenticar tu juego:
- Implementa la autenticación de la plataforma inicializando el SDK de la versión 2 de los Servicios de juego de Play en el inicio. Para obtener más información, consulta Autenticación de la plataforma para juegos de Android. Este es un paso 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 cuando se realice la autenticación correctamente.
Opciones de creación de perfiles
El perfil de los Servicios de juego de Play es necesario para que los jugadores interactúen 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.
Para decidir la experiencia adecuada para tus usuarios, elige una de las siguientes opciones:
Mensajes activados automáticamente para crear perfiles: Los mensajes para crear perfiles aparecen automáticamente de forma predeterminada cuando inicias un juego sin un perfil de Servicios de juego de Play.
Mensaje para crear un perfil cuando inicias un juego (haz clic para ampliar). Inhabilita las indicaciones para crear perfiles en el lanzamiento y agrega indicaciones manuales después de la inicialización del juego Puedes inhabilitar las indicaciones para crear perfiles que se activan automáticamente a través del archivo de manifiesto. Esto permite que los usuarios sin un perfil de los Servicios de juego de Play continúen con los métodos de autenticación implementados sin que se les solicite de inmediato que creen un perfil de los Servicios de juego de Play.
Si bien los usuarios pueden acceder con cualquier proveedor de identidad, te recomendamos que inicies un mensaje de creación de perfil Obtén el resultado de la autenticación para fomentar el registro en la plataforma de Play Juegos. Activa este mensaje cuando lo consideres oportuno, pero verifica que aparezca antes de que los usuarios avancen significativamente en funciones como los logros y los rankings.
Considera activar la instrucción de perfil en los siguientes momentos recomendados:
- Después de completar un instructivo
- Durante un momento recompensado (por ejemplo, ganar una partida, recolectar un elemento raro o alcanzar un hito)
- En el momento de iniciar una segunda sesión
Flujo de autenticación recomendado
Para cumplir con los lineamientos sobre la experiencia del usuario de Google Play Juegos Level Up, verifica que satisfagas los requisitos de continuidad del jugador. Para que los jugadores accedan correctamente a tu juego, usa el siguiente flujo de autenticación:
- Durante la secuencia de inicio del juego, revisa las opciones de creación de perfiles y elige una.
- Si el acceso automático no funciona o el usuario rechaza esta opción, muestra un botón de acceso manual en caso de que el usuario desee acceder más tarde.
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, tu integración del servidor de juegos y tu 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.
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 autorización del servidor.
Varios servicios de autenticación
Los Servicios de juego de Play proporcionan una identidad de juego para los jugadores de Android, pero no es necesario que se trate de la única identidad conectada con tus usuarios. Puedes autenticar a los jugadores usando los Servicios de juego de Play, un ID de red social y tu propio sistema de ID dentro del juego, todo al mismo tiempo.
API de Recall
La API de Recall permite que los juegos administren los vínculos entre los usuarios de los PGS y sus cuentas dentro del juego almacenando tokens de recuperación con los servidores de Google. Para obtener más información sobre cómo habilitar esta función, consulta Cómo integrar la API de Recall de PGS en tu juego.
Integración de cliente de juego
Cuando integres la autenticación en tu proyecto de juego, te recomendamos el siguiente flujo de usuarios:
Durante la secuencia de inicio del juego, se inician las opciones de creación de perfiles y se intenta hacer que el usuario acceda o cree una cuenta nueva.
Si la autenticación automática no funciona o el usuario rechaza esta opción, muestra un botón de acceso manual en caso de que el usuario desee acceder más adelante.
Para obtener información sobre cómo integrar la autenticación en tu proyecto de juego, consulta la guía de introducción para tu tipo de proyecto:
Integración del servidor de juegos
Puedes obtener un código de autorización del servidor llamando a requestServerSideAccess una vez que hayas verificado que el jugador se autenticó. Pasa este código de autorización del servidor a tu servidor de juegos de backend para comunicarte directamente con los servidores de los Servicios de juego de Play. Esta comunicación permite que tu servidor acceda a los datos del jugador, incluidos los siguientes:
- ID de jugador
- Perfil
- Lista de amigos
- Progreso en el juego
- Logros
Luego, tu servidor usa este código de autorización con la API de REST para interactuar de forma segura con los servidores de los Servicios de juego de Play. Para obtener más información, consulta Acceso del servidor a los Servicios de juego de Play.
Cuota de solicitud de acceso
Existe una cuota diaria para las solicitudes de acceso con los Servicios de juego de Play. Para obtener más información, consulta Administra tu cuota diaria.