Amis

Utilisez les API Friends pour compléter et améliorer votre système d'amis existant dans le jeu et les autres systèmes sociaux auxquels votre jeu peut accéder. Les joueurs bénéficieront ainsi des fonctionnalités suivantes :

  • Ils pourront trouver des amis dans le jeu.

  • Ils pourront comparer leurs scores avec ceux de leurs amis dans les classements.

  • Ils pourront combiner la liste de leurs amis Play Jeux avec celles du jeu.

  • Ils pourront identifier un autre joueur grâce à un pop-up de profil dans le jeu. Ce pop-up affiche un pseudo que le joueur a donné à son ami pour qu'il sache avec qui il joue.

Importer des amis

Principes de base

Ces API vous permettent d'effectuer les actions suivantes :

  • Charger des amis : vérifiez si le joueur a autorisé le jeu à accéder aux informations de la liste d'amis. Si l'accès est accordé, vous pouvez obtenir la liste des objets Player correspondant aux amis du joueur connecté.
  • Lancer une vue du profil Play Jeux d'un autre joueur : vous pouvez ouvrir cette vue pour afficher le pseudo que le joueur connecté a donné à l'autre joueur. Cette vue offre également des commandes de gestion des amis et ne fait pas sortir le joueur de votre jeu.
  • Fournir des commandes utilisateur : l'utilisateur dispose de commandes pour gérer la façon dont ses amis voient son profil Play Jeux, ainsi que l'accès dont bénéficient les jeux à sa liste d'amis. L'utilisateur peut choisir d'accorder automatiquement à tous les jeux l'accès à la liste d'amis ou d'approuver individuellement l'accès pour chaque jeu. Par conséquent, lors du chargement de la liste d'amis, un rappel peut avoir lieu pour afficher une demande d'accès.

Importer une liste d'amis Play Jeux

Vous pouvez utiliser les API Friends pour obtenir la liste des amis Play Jeux de vos joueurs et les ajouter à la liste d'amis dans un jeu.

Les nouveaux utilisateurs disposeront d'une liste d'amis de départ, tandis que les utilisateurs existants pourront importer leurs amis Play Jeux dans n'importe quelle liste d'amis intégrée à un jeu. Par conséquent, ils auront accès au plus grand nombre de joueurs possible auxquels ils pourront se mesurer.

Ajouter des amis Play Jeux à votre jeu

Pour ajouter des amis Play Jeux à une liste existante d'amis dans un jeu, associez leur ID Play Jeux aux informations correspondantes du joueur dans votre base de données interne. Assurez-vous qu'un bouton représentant l'icône Play Jeux s'affiche à côté de ces amis. Lorsqu'il sera sélectionné, ce bouton affichera le profil de l'autre joueur. Vos utilisateurs pourront ainsi vérifier qui sont leurs amis.

Lorsque vous utilisez la liste d'amis depuis un serveur backend, chargez-la de manière sécurisée à l'aide de l'API REST au lieu de transmettre le résultat de l'API Android. Veillez à utiliser l'ID de joueur renvoyé par players.get(me) dans l'API REST pour le joueur actuellement connecté, car il sera cohérent avec l'ID vu par les autres joueurs.

Si la liste d'amis augmentée n'est pas stockée (mais simplement utilisée au moment du visionnage), aucune action supplémentaire n'est nécessaire.

Accorder l'accès à Play Jeux

Si votre jeu ne dispose pas déjà d'un accès à Play Jeux, il est de bon ton de demander l'autorisation des utilisateurs lorsqu'ils consultent la liste d'amis dans votre jeu. Par exemple, vous pouvez ajouter un bouton intitulé Importer des amis Play Jeux qui invite l'utilisateur à donner son consentement lorsqu'il appuie dessus. Assurez-vous d'utiliser le logo Play Jeux sur tous les boutons mentionnant ce service.

Afficher le profil d'un autre joueur

Vous pouvez autoriser le joueur connecté à afficher le profil Play Jeux d'un autre joueur. Cette fonctionnalité lui permettra de voir le nom qu'il a donné à l'autre joueur et de déterminer s'il est déjà ami, ce qui lui donnera plus de contexte sur la relation qui les unit. Si les joueurs ne sont pas encore amis, le joueur connecté aura à sa disposition des commandes de gestion du statut d'ami dans la vue du profil. Lorsque des amis sont créés directement à partir du jeu, le nom par défaut des deux joueurs est leur nom de joueur (le cas échéant). Le nom du jeu à partir duquel la relation amicale a commencé s'affiche également.

Afficher le profil d'un autre joueur

Classements sociaux

Les API Friends peuvent également être utilisées pour les classements. Utilisez cette fonctionnalité pour afficher le classement du joueur actif parmi ses amis Play Jeux. Notez que cela ne s'applique qu'aux utilisateurs qui ont choisi de partager ces informations avec votre application et que s'ils sont amis dans Play Jeux. Pour proposer cette fonctionnalité, le jeu présente une commande à l'utilisateur. Cette commande utilise l'argument collection pour sélectionner la vue sociale dans le classement. Pour en savoir plus, consultez la section Classements publics et sociaux.

Amis figurant dans un classement

Si vous implémentez la collecte des classements sociaux, l'appel pour charger les scores correspondants peut renvoyer une exception de résolution obligatoire, semblable à celle de loadFriends(). Si vous implémentez l'interface utilisateur par défaut fournie par Play Jeux (par exemple, getLeaderboardIntent()), cette tâche est gérée automatiquement.

Étapes suivantes

Avant de commencer à utiliser les API Friends, procédez comme suit :