Freunde

Verwende Friends APIs, um dein bestehendes In-Game-Freundessystem zu ergänzen und zu verbessern. und andere soziale Systeme, auf die dein Spiel zugreifen kann. Dadurch kannst du Spielern Folgendes ermöglichen:

  • Finde ihre Freunde in deinem Spiel.

  • Punktzahlen mit Freunden in Bestenlisten vergleichen

  • die Liste ihrer Play Spiele-Freunde mit bestehenden In-Game-Listen mit Freunde.

  • Mithilfe eines Pop-up-Fensters im Spielprofil kannst du andere Spieler identifizieren. In diesem Pop-up-Fenster wird ein Spitznamen, den der aktuelle Spieler einem Freund gegeben hat, damit er weiß, mit denen sie spielen.

Freunde importieren

Grundlagen

Mit diesen APIs können Sie die folgenden Aktionen ausführen:

  • Freunde laden: Hier können Sie prüfen, ob der Spieler dem Spiel Zugriff gewährt hat. Informationen zur Kontaktliste. Wenn der Zugriff gewährt wurde, kannst du eine Liste der Spieler aufrufen Objekte, die den Freunden des angemeldeten Spielers entsprechen
  • Play Spiele-Profil eines anderen Spielers aufrufen: Sie können um den Namen anzuzeigen, den der angemeldete Spieler Player. In dieser Ansicht findest du auch Steuerelemente zur Freundschaftsverwaltung. Du kannst den Spieler aus Ihrem Spiel zu verabschieden.
  • Nutzersteuerungen bereitstellen: Der Nutzer kann festlegen, wie seine Das Play Spiele-Profil ist für Freunde und ihre Freundesliste sichtbar für Spiele sichtbar. Für den Zugriff auf die Freundesliste hat der Nutzer folgende Möglichkeiten: Der Nutzer erhält automatisch Zugriff auf alle Spiele oder kann das Spiel einzeln auswählen. den Zugriff für jedes Spiel zu genehmigen. Beim Laden der Freundesliste Das Ergebnis kann ein Callback sein, mit dem eine Zugriffsanfrage angezeigt wird.

Play Spiele-Freundesliste importieren

Mit den Friends APIs kannst du eine Liste der Play Spiele deiner Spieler abrufen und füge sie deiner In-Game-Freundesliste hinzu.

Neue Nutzer erhalten eine erste Liste mit Freunden, mit denen sie spielen können, sowie bestehende Nutzer. ihre Play Spiele-Freunde in jede beliebige In-Game-Freundesliste importieren. Dadurch steht Ihren Nutzern die größtmögliche Anzahl an Spielern zur Verfügung. mit denen sie konkurrieren oder mit denen sie konkurrieren.

Play Spiele-Freunde zu deinem Spiel hinzufügen

Füge Play Spiele-Freunde einer vorhandenen In-Game-Freundesliste hinzu, indem du ihre Play Spiele-ID mit den entsprechenden Spielerinformationen in Ihrer internen Datenbank. Achte darauf, dass eine Schaltfläche mit der Play Spiele-Konsole vorhanden ist. neben diesen Freunden, das beim Drücken das Profil des anderen Spielers anzeigt. damit Ihre Nutzer wissen, wer die Freunde sind.

Wenn du die Freundesliste von einem Backend-Server verwendest, lade sie sicher. die REST API verwenden, anstatt das Ergebnis der Android API zu übergeben. Achten Sie darauf, um die von players.get(me) in der REST API zurückgegebene Spieler-ID für das aktuell angemeldeter Spieler, da dies mit der ID übereinstimmt, die andere Spieler sehen .

Wenn die Liste der erweiterten Freunde nicht gespeichert ist, sondern nur verwendet wird, angezeigt wird, ist kein zusätzlicher Aufwand erforderlich.

Play Spiele-Zugriff gewähren

Falls Sie noch keinen Zugriff auf Play Spiele haben, ist jetzt ein guter Zeitpunkt, um ihre Zustimmung einzuholen, wenn sie Ihre Freundesliste im Spiel aufrufen. Für können Sie eine Schaltfläche namens Play Spiele-Freunde importieren hinzufügen, fordert den Nutzer beim Tippen auf die Einwilligung. (Verwenden Sie die Play Spiele-Logo auf allen Schaltflächen, in denen der Dienst erwähnt wird.

Profil eines anderen Spielers ansehen

Sie können Ihrem angemeldeten Spieler erlauben, die Play Spiele-Profil. Dadurch kann der angemeldete Spieler den Namen dem anderen Spieler gegeben haben und ob er bereits befreundet ist, Kontext zur Beziehung hinzugefügt. Sind die Spieler noch nicht befreundet, Der angemeldete Spieler sieht die Einstellungen zur Freundschaftsverwaltung im Profil. Ansicht. Wenn innerhalb des Spiels Freundschaften geschlossen werden, werden die Standardnamen für Die beiden Spieler sind ihre Namen im Spiel (falls Sie einen angeben). Der Name des Das Spiel, in dem die Freundschaft entstanden wurde, ist ebenfalls zu sehen.

Profil eines anderen Spielers ansehen

Bestenlisten in sozialen Netzwerken

Die Friends APIs können auch für Bestenlisten verwendet werden. Mit dieser Funktion können Sie Ranking des aktuellen Spielers unter seinen Play Spiele-Freunden Beachten Sie, dass Dies gilt nur für Nutzer, die angegeben haben, dass diese Informationen mit Ihrem App und ob die Nutzer in Play Spiele Freunde sind. Um dies zu unterstützen aktiviert, zeigt das Spiel dem Nutzer ein Steuerelement an. Dieses Steuerelement verwendet die Argument collection, um die soziale Ansicht der Bestenliste auszuwählen. Weitere Informationen finden Sie im Abschnitt öffentliche Bestenlisten und Bestenlisten für soziale Netzwerke.

Freunde in einer Bestenliste

Wenn Sie die Sammlung von Bestenlisten für soziale Netzwerke implementieren, wird der Aufruf zum Laden der Bei Bestenlistenergebnissen wird möglicherweise eine Ausnahme wie folgt zurückgegeben: eine Ausnahme, für die eine Einwilligung erforderlich ist. das von loadFriends() Wenn Sie die von Play Spiele bereitgestellte Standard-UI implementieren (z. B. getLeaderboardIntent()), erledigt das für Sie automatisch.

Nächste Schritte

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