Amigos

Usa las APIs de Friends para complementar y mejorar tu sistema de amigos existente en el juego y otros sistemas sociales a los que pueda acceder tu juego. De esta manera, podrás permitir que los jugadores hagan lo siguiente:

  • Encuentren a sus amigos en tu juego.

  • Comparen puntuaciones con sus amigos en las tablas de clasificación.

  • Combinen la lista de amigos de Play Juegos con las listas de amigos existentes en el juego.

  • Identifiquen a otro jugador con una ventana emergente de perfil en el juego. En esta ventana emergente, se muestra el sobrenombre que el jugador actual le asignó a su amigo, para que sepa con quién está jugando.

Importar amigos

Conceptos básicos

Estas APIs te permiten realizar las siguientes acciones:

  • Cargar amigos: Puedes comprobar si el jugador permitió que el juego acceda a la información de la lista de amigos. Si se te otorga acceso, podrás obtener una lista de objetos del jugador que corresponden a los amigos del jugador que accedió.
  • Abrir una vista del perfil de Play Juegos de otro jugador: Puedes abrir esta vista para mostrar el nombre que el jugador que accedió le asignó al otro jugador. Esta vista también ofrece controles de administración de amistad y no sacará al jugador del juego.
  • Proporcionar controles al usuario: El usuario tiene controles a fin de administrar cómo sus amigos pueden ver su perfil de Play Juegos y cómo los juegos pueden acceder a su lista de amigos. A fin de acceder a la lista de amigos, el usuario puede optar por otorgar acceso automáticamente a todos los juegos, o bien decidir aprobarlo de forma individual para cada uno de ellos. En consecuencia, cuando se carga la lista de amigos, el resultado puede ser una devolución de llamada a fin de mostrar una solicitud para el acceso.

Importa una lista de amigos de Play Juegos

Puedes usar las APIs de Friends para obtener una lista de amigos de Play Juegos de los jugadores y agregarlos a tu lista en el juego.

Los usuarios nuevos tendrán una lista inicial de amigos para jugar, y los usuarios existentes podrán importar a sus amigos de Play Juegos a cualquier lista de amigos en el juego. Como resultado, los usuarios tendrán el mayor conjunto posible de jugadores con quienes jugar o contra quienes competir.

Agrega amigos de Play Juegos a tu juego

Agrega amigos de Play Juegos a cualquier lista de amigos en el juego mediante la asociación de su ID de Play Juegos con la información de jugador correspondiente en tu base de datos interna. Asegúrate de tener un botón con el ícono de Play Juegos junto a estos amigos que muestre el perfil del otro jugador cuando se presiona, de modo que los usuarios puedan saber quiénes son.

Cuando uses la lista de amigos desde un servidor de backend, cárgala de forma segura con la API de REST, en lugar de pasar el resultado de la API de Android. Asegúrate de usar el ID de jugador que muestra players.get(me) en la API de REST para el jugador que accedió, ya que este será coherente con el ID que vieron otros jugadores.

Si la lista de amigos aumentada no se almacena (pero solo se usa en el momento de visualización), no se necesita ninguna tarea adicional.

Otorga acceso a Play Juegos

Si tu juego aún no tiene acceso a Play Juegos, un buen momento para solicitarles el consentimiento a los usuarios es cuando vean tu lista de amigos en el juego. Por ejemplo, podrías agregar un botón con el nombre Importar amigos de Play Juegos, que le solicite el consentimiento al usuario cuando lo presione. (Asegúrate de usar el logotipo de Play Juegos en cualquier botón que mencione el servicio).

Consulta el perfil de otro jugador

Puedes permitir que el jugador que accedió vea el perfil de Play Juegos de otro jugador. Esto le permite al jugador que accedió ver el nombre que le asignó al otro jugador y si son amigos o no, lo que le brinda contexto adicional sobre la relación. Si los jugadores aún no son amigos, el usuario que accedió verá los controles de administración de amistad en la vista de perfil. Cuando se crean amistades desde el juego, los nombres predeterminados para los dos jugadores son los nombres en el juego (si proporcionas uno). También se muestra el nombre del juego en el que se inició la amistad.

Consulta el perfil de otro jugador

Tablas de clasificación sociales

Las APIs de Friends también se pueden usar para tablas de clasificación. Usa esta función para mostrar la clasificación del jugador actual entre sus amigos de Play Juegos. Ten en cuenta que esto solo se aplica a los usuarios que hayan elegido compartir esta información con tu aplicación y si los usuarios son amigos en Play Juegos. Para admitir esta función, el juego le muestra un control al usuario. Este control usa el argumento collection para seleccionar la vista social de la tabla de clasificación. Para obtener más información, consulta la sección sobre tablas de clasificación públicas y sociales.

Amigos en una tabla de clasificación

Si implementas la colección de tablas de clasificación sociales, la llamada para cargar las puntuaciones de estas tablas puede mostrar una excepción de resolución que requiere consentimiento similar a la de loadFriends(). Si implementas la IU predeterminada que proporciona Play Juegos (por ejemplo, getLeaderboardIntent()), esta acción se controla automáticamente.

Próximos pasos

Antes de comenzar a usar las APIs de Friends, debes hacer lo siguiente: