Freunde

Mit den Friends APIs können Sie Ihr bestehendes Freundesystem im Spiel und andere soziale Systeme, auf die Ihr Spiel möglicherweise zugreift, ergänzen und verbessern. Dadurch ermöglichst du Spielern:

  • ihre Freunde im Spiel zu finden.

  • Punktzahlen auf Bestenlisten mit Freunden zu vergleichen.

  • Die Liste ihrer Play Spiele-Freunde mit vorhandenen In-Game-Freundeslisten zu kombinieren.

  • Einen anderen Spieler über ein Pop-up-Fenster mit seinem In-Game-Profil zu identifizieren. In diesem Pop‑up wird ein Spitzname angezeigt, den der aktuelle Spieler seinem Freund gegeben hat, damit er weiß, mit wem er spielt.

Freunde importieren

Grundlegende Informationen

Mit diesen APIs kannst du die folgenden Aktionen ausführen:

  • Freunde laden: Du kannst prüfen, ob der Spieler dem Spiel den Zugriff auf Informationen aus der Freundesliste erlaubt hat. Wenn der Zugriff gewährt wird, kannst du eine Liste von Player-Objekten abrufen, die den Freunden des angemeldeten Spielers entsprechen.
  • Ansicht des Play Spiele-Profils eines anderen Spielers starten: Du kannst diese Ansicht öffnen, um den Namen des anderen Spielers anzuzeigen, der vom angemeldeten Spieler angegeben wurde. Diese Ansicht bietet auch Steuerelemente für die Freundschaftsverwaltung und der Spieler wird nicht aus deinem Spiel entfernt.
  • Nutzereinstellungen bereitstellen: Nutzer können festlegen, wie ihr Play Spiele-Profil für Freunde sichtbar ist und wie ihre Freundesliste in Spielen angezeigt wird. Für den Zugriff auf die Freundesliste kann der Nutzer wählen, ob er den Zugriff für alle Spiele automatisch gewähren oder den Zugriff für jedes Spiel einzeln genehmigen möchte. Wenn die Freundesliste geladen wird, kann das Ergebnis daher ein Callback sein, um eine Zugriffsanfrage anzuzeigen.

Play Spiele-Freundesliste importieren

Mit den Friends APIs kannst du eine Liste der Play Spiele-Freunde deiner Spieler abrufen und sie der Freundesliste im Spiel hinzufügen.

Neue Nutzer haben eine Startliste mit Freunden, mit denen sie spielen können, und bestehende Nutzer können ihre Play Spiele-Freunde in beliebige In-Game-Freundeslisten importieren. So haben Ihre Nutzer die größtmögliche Auswahl an Spielern, mit denen sie spielen oder gegen die sie antreten können.

Play Spiele-Freunde zu deinem Spiel hinzufügen

Füge einer vorhandenen In-Game-Freundesliste Play Spiele-Freunde hinzu, indem du deine Play Spiele-ID mit den entsprechenden Spielerinformationen in deiner internen Datenbank verknüpfst. Achte darauf, dass neben diesen Freunden ein Button mit dem Play Spiele-Symbol angezeigt wird, der beim Klicken das Profil des anderen Spielers öffnet, damit deine Nutzer wissen, wer die Freunde sind.

Wenn du die Freundesliste von einem Backend-Server verwendest, lade sie sicher über die REST API, anstatt das Ergebnis der Android-API weiterzugeben. Verwende in der REST API für den aktuell angemeldeten Spieler die Spieler-ID, die von players.get(me) zurückgegeben wird, da diese mit der ID übereinstimmt, die von anderen Spielern gesehen wird.

Wenn die erweiterte Freundesliste nicht gespeichert, sondern nur zum Zeitpunkt der Anzeige verwendet wird, sind keine zusätzlichen Maßnahmen erforderlich.

Play Spiele-Zugriff gewähren

Wenn dein Spiel noch keinen Zugriff auf Play Spiele hat, ist ein guter Zeitpunkt, Nutzer um ihre Einwilligung zu bitten, wenn sie die Freundesliste im Spiel aufrufen. Du kannst beispielsweise eine Schaltfläche mit dem Namen Play Spiele-Freunde importieren hinzufügen, die den Nutzer beim Tippen um die Einwilligung bittet. Verwende das Play Spiele-Logo auf allen Schaltflächen, auf denen der Dienst erwähnt wird.

Profil eines anderen Spielers ansehen

Du kannst dem angemeldeten Spieler erlauben, das Play Spiele-Profil eines anderen Spielers aufzurufen. So kann der angemeldete Spieler den Namen sehen, den er dem anderen Spieler gegeben hat, und ob sie bereits Freunde sind. Das gibt ihm zusätzlichen Kontext zur Beziehung. Wenn die Spieler noch nicht befreundet sind, werden dem angemeldeten Spieler in der Profilansicht Steuerelemente für die Freundschaftsverwaltung angezeigt. Wenn Freundschaften im Spiel geschlossen werden, sind die Standardnamen für die beiden Spieler ihre In-Game-Namen (sofern angegeben). Der Name des Spiels, in dem die Freundschaft geschlossen wurde, wird ebenfalls angezeigt.

Profil eines anderen Spielers ansehen

Bestenlisten in den sozialen Medien

Die Friends APIs können auch für Bestenlisten verwendet werden. Mit dieser Funktion kannst du das Ranking des aktuellen Spielers unter seinen Play-Spiele-Freunden anzeigen. Das gilt nur für Nutzer, die diese Informationen für deine Anwendung freigegeben haben und die in Play Spiele Freunde sind. Um diese Funktion zu unterstützen, bietet das Spiel dem Nutzer eine Steuerung. Mit diesem Steuerelement wird das Argument collection verwendet, um die soziale Ansicht der Bestenliste auszuwählen. Weitere Informationen findest du im Abschnitt Öffentliche und soziale Bestenlisten.

Wenn du die Erfassung von Social Leaderboards implementierst, kann beim Aufruf zum Laden der Leaderboard-Ergebnisse eine Ausnahme für die Auflösung zurückgegeben werden, die eine Einwilligung erfordert, ähnlich der von loadFriends(). Wenn du die von Play Spiele bereitgestellte Standard-Benutzeroberfläche implementierst (z. B. getLeaderboardIntent()), wird dies automatisch für dich erledigt.

Nächste Schritte

Bevor du die Friends APIs verwendest, musst du Folgendes tun: