El acceso a los Servicios de juego de Play te proporciona la identidad de un jugador en el juego, que es una identidad específica de los juegos a nivel de la plataforma para los jugadores de Android. Esta identidad ayuda a establecer una relación entre el juego y el jugador. Los jugadores están más dispuestos a usar esta identidad para acceder que los sistemas centralizados alternativos.
Además, el acceso te brinda un identificador sólido y coherente que puedes usar como clave para un sistema de almacenamiento en la nube. El almacenamiento en la nube tiene un gran valor, ya que permite a los jugadores hacer lo siguiente:
- Continuar desde donde el jugador dejó si cambia o restablece su dispositivo
- Jugar en varios dispositivos (por ejemplo, en otro teléfono o en una Chromebook)
- Desinstalar el juego y volver a instalarlo
Puedes usar la identidad de los Servicios de juego de Play como clave para tu propia solución de almacenamiento en la nube o bien puedes usar el servicio de Juegos guardados de forma gratuita.
Los Servicios de juego de Play (PGS) admiten el acceso automático, una forma sin fricciones de acceder a los jugadores, así como el acceso manual, que es un proceso de un clic. En este documento, se describen estos diferentes métodos de acceso.
Flujo de acceso recomendado
Para que los jugadores accedan correctamente a tu juego, usa el siguiente flujo de acceso:
- Durante la secuencia de inicio del juego, prueba el acceso automático para que el jugador acceda automáticamente.
- Si el acceso automático no funciona y el dispositivo del usuario está en línea, prueba el acceso manual.
- Si se rechaza el acceso manual, recuerda la elección del usuario y no vuelvas a mostrar el acceso manual, pero sigue intentando el acceso automático al inicio.
Además, debes asegurarte de que los usuarios puedan acceder a tu juego con su cuenta de los Servicios de juego de Play con un botón exclusivo y fácil de encontrar.
Acceso automático
El acceso automático permite que los usuarios accedan a tu juego sin fricciones, ya que es automático. Si tu juego solicita que el usuario acceda y la configuración de acceso automático está habilitada (en la app de Google Play Juegos), recibirás las credenciales de identidad de los PGS del usuario y el usuario verá la experiencia de acceso a los PGS.
El acceso automático es una configuración que los usuarios pueden controlar. Los usuarios pueden elegir acceder automáticamente en todos los juegos, o bien recibir una solicitud de acceso cada vez.
Acceso manual
Si un usuario no accede automáticamente al juego, puedes pedirle que lo haga manualmente. Los usuarios pueden acceder con un clic desde un cuadro de diálogo que se muestra en la parte superior del juego.
Permite las ventanas emergentes de los PGS para obtener la experiencia de acceso correcta
Cuando se usan los PGS, los usuarios deben saber que accedieron. Para ello, se muestra la experiencia de acceso de los PGS.
Para mostrar la experiencia de acceso, llama al método setViewForPopups() de la clase GamesClient durante el inicio del juego. Esto es fundamental para permitir la experiencia del usuario correcta.
Permisos de OAuth y PGS
Los PGS se basan en el sistema OAuth para permitir que los usuarios otorguen al juego acceso a su cuenta. Los Permisos de OAuth son permisos que puedes solicitar como desarrollador. Si se otorgan, estos permisos permiten que tu juego llame a ciertas APIs en nombre del usuario y también te dan acceso a ciertas partes de su Cuenta de Google.
Los PGS 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.
Tu juego puede solicitar cualquier permiso que necesites para crear una gran experiencia de juego para tus usuarios. Tu juego puede solicitar todos los permisos que necesita en un paquete, lo que limita la cantidad de solicitudes de acceso a la Cuenta de Google. Sin embargo, este enfoque tiene un inconveniente importante. Si solicitas más que los permisos específicos de los PGS, el acceso automático no se puede realizar correctamente. El acceso automático es la mejor manera de que los jugadores accedan a tu juego.
La práctica recomendada es usar solicitudes de alcance incrementales. Tu juego debe solicitar primero los ámbitos solo de los PGS en la solicitud inicial y solicitar otros ámbitos por separado en un momento más relevante.
El acceso de OAuth se otorga mediante una pantalla diferente para cada permiso. Esto permite que los usuarios decidan, de forma detallada, a qué permisos otorgar acceso. Si usas el acceso automático con solo permisos de los PGS, los usuarios no tendrán que interactuar con ninguna solicitud de OAuth, lo que reducirá los inconvenientes de acceso.
Compatibilidad con varios métodos de acceso
Los PGS 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 hacer que los jugadores accedan usando los PGS, un ID de red social y tu propio sistema de ID dentro del juego, todo al mismo tiempo. Cada sistema proporciona un valor único para ti y los jugadores, y todos pueden trabajar juntos a fin de brindar una gran experiencia para los jugadores de Android.
Cómo recuperar y verificar de forma segura la identidad del jugador para la integración de backend
Puedes solicitar un código de Auth del servidor de modo que pueda comunicarse directamente con los servidores de los Servicios de juego de Play mediante la API de REST y con la autoridad del jugador que accedió. Esto permite el acceso directo al ID del jugador, al perfil y a otra información (como la lista de amigos, si se dio autorización). Si almacenas ID de jugador, ID de amigo u otros datos relacionados en tu backend, debe usarse este método para eliminar la manipulación potencial de estos campos del dispositivo.
Además, en el caso de algunos juegos y jugadores más antiguos, es posible que el ID que muestra el SDK de Android para un jugador no sea el mismo que ven otros jugadores cuando observan a ese jugador en el mismo juego. En particular, esto resulta relevante cuando se usa la lista de amigos. Sin embargo, el player_id que se muestra dentro de la API de REST siempre es coherente y siempre es el ID que ven otros jugadores.
Si deseas obtener más información, consulta la documentación sobre el Acceso sin conexión y la API de REST.
Implementación del cliente
Si deseas obtener información para implementar la compatibilidad de acceso en Android, consulta Acceso en juegos para Android.