Freunde

Verwende die Friends APIs, um dein bestehendes In-Game-Freundessystem und andere soziale Systeme, auf die dein Spiel möglicherweise zugreift, zu ergänzen und zu verbessern. Damit können Sie Spielern Folgendes ermöglichen:

  • Finde ihre Freunde in deinem Spiel.

  • Vergleichen Sie Ihre Punktzahlen mit ihren Freunden in den Bestenlisten.

  • die Liste ihrer Play Spiele-Freunde mit vorhandenen In-Game-Listen von Freunden kombinieren.

  • Über das Pop-up-Fenster im Spiel kannst du einen anderen Spieler identifizieren. In diesem Pop-up wird ein Alias angezeigt, den der aktuelle Spieler seinem Freund gegeben hat, damit er weiß, mit wem er spielt.

Freunde importieren

Grundlegende Informationen

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

  • Freunde laden: Sie können prüfen, ob der Spieler dem Spiel den Zugriff auf Informationen aus der Freundesliste gewährt hat. Wenn der Zugriff gewährt wird, können Sie eine Liste der Spielerobjekte abrufen, die den Freunden des angemeldeten Spielers entsprechen.
  • Ansicht des Play Spiele-Profils eines anderen Spielers öffnen: Sie können diese Ansicht öffnen, um den Namen zu sehen, den der angemeldete Spieler dem anderen Spieler gegeben hat. Diese Ansicht bietet auch Funktionen zum Verwalten von Freundschaften und lenkt den Spieler nicht aus Ihrem Spiel.
  • Nutzersteuerung bereitstellen: Der Nutzer kann festlegen, wie sein Play Spiele-Profil für Freunde und seine Freundesliste für Spiele sichtbar sind. Für den Zugriff auf die Freundesliste kann der Nutzer den Zugriff automatisch für alle Spiele gewähren oder ihn für jedes Spiel einzeln genehmigen. Daher kann das Ergebnis beim Laden der Freundesliste ein Callback zur Anzeige einer Zugriffsanfrage sein.

Play Spiele-Freundesliste importieren

Mit den Friends APIs können Sie eine Liste der Play Spiele-Freunde Ihrer Spieler abrufen und sie Ihrer Freundesliste im Spiel hinzufügen.

Neue Nutzer haben eine Anfangsliste mit Freunden, mit denen sie spielen können, und bestehende Nutzer können ihre Play Spiele-Freunde in eine beliebige In-Game-Listen mit Freunden importieren. Dadurch haben Ihre Nutzer die größtmögliche Anzahl von Spielern, mit denen sie spielen oder gegen sie antreten können.

Deinem Spiel Play Spiele-Freunde hinzufügen

Du kannst Play Spiele-Freunde zu einer vorhandenen In-Game-Freundesliste hinzufügen, indem du ihre Play Spiele-ID mit den entsprechenden Spielerinformationen in deiner internen Datenbank verknüpfst. Achte darauf, dass neben diesen Freunden eine Schaltfläche mit dem Play Spiele-Symbol vorhanden ist. Wenn darauf geklickt wird, muss das Profil des anderen Spielers angezeigt werden, damit deine Nutzer wissen, wer die Freunde sind.

Wenn Sie die Freundesliste von einem Back-End-Server verwenden, sollten Sie sie mit der REST API sicher laden, anstatt das Ergebnis der Android API zu übergeben. Verwenden Sie die von players.get(me) in der REST API zurückgegebene Spieler-ID für den aktuell angemeldeten Spieler, da sie mit der ID übereinstimmt, die von anderen Spielern gesehen wird.

Wenn die erweiterte Freundesliste nicht gespeichert, sondern nur zum Zeitpunkt der Anzeige verwendet wird, ist keine zusätzliche Arbeit erforderlich.

Play Spiele-Zugriff gewähren

Wenn Ihr Spiel noch keinen Zugriff auf Play Spiele hat, sollten Sie die Nutzer um ihre Einwilligung bitten, wenn sie sich Ihre In-Game-Freundesliste ansehen. Sie können beispielsweise eine Schaltfläche mit dem Namen Play Spiele-Freunde importieren hinzufügen, mit der der Nutzer um seine Zustimmung gebeten wird, wenn er darauf tippt. Achten Sie darauf, das Play Spiele-Logo auf allen Schaltflächen zu verwenden, auf denen der Dienst erwähnt wird.

Profil eines anderen Spielers ansehen

Sie können Ihrem 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 er bereits befreundet ist, und ihm zusätzlichen Kontext zu der Beziehung liefern. Wenn die Spieler noch keine Freunde sind, sieht der angemeldete Spieler in der Profilansicht Steuerelemente zum Verwalten von Freundschaften. Wenn innerhalb des Spiels Freundschaften entstehen, sind die Standardnamen für die beiden Spieler die Namen im Spiel (falls Sie einen angeben). Der Name des Spiels, in dem die Freundschaft eröffnet wurde, wird ebenfalls angezeigt.

Profil eines anderen Spielers ansehen

Bestenlisten in sozialen Netzwerken

Die Friends APIs können auch für Bestenlisten verwendet werden. Mit dieser Funktion wird das Ranking des aktuellen Spielers unter seinen Play Spiele-Freunden angezeigt. Dies gilt nur für Nutzer, die diese Informationen mit Ihrer App geteilt haben, und wenn die Nutzer in Play Spiele Freunde sind. Zur Unterstützung dieser Funktion stellt das Spiel dem Nutzer ein Steuerelement zur Verfügung. Dieses Steuerelement verwendet das Argument collection, um die Social-Media-Ansicht der Bestenliste auszuwählen. Weitere Informationen finden Sie im Abschnitt zu öffentlichen Bestenlisten und sozialen Bestenlisten.

Freunde in einer Bestenliste

Wenn Sie die Sammlung von Bestenlisten in sozialen Netzwerken implementieren, kann der Aufruf zum Laden der Bestenlisten-Punktzahlen eine Lösungsausnahme gemäß der Einwilligung zurückgeben, die der Ausnahme von loadFriends() ähnelt. Wenn du die von Play Spiele bereitgestellte Standard-UI implementierst (z. B. getLeaderboardIntent()), wird dies automatisch für dich übernommen.

Nächste Schritte

Bevor Sie mit der Nutzung der Friends APIs beginnen, gehen Sie wie folgt vor: