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 können Spieler:

  • Finde die Freunde des Spielers in deinem Spiel.

  • Punktzahlen auf Bestenlisten mit Freunden vergleichen

  • Die Liste der Play Spiele-Freunde des Nutzers wird mit vorhandenen In-Game-Freundeslisten kombiniert.

  • Sie können einen anderen Spieler über ein Pop-up-Fenster mit seinem In-Game-Profil 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 können Sie die folgenden Aktionen ausführen:

  • Freunde laden: Sie können prüfen, ob der Spieler dem Spiel den Zugriff auf Informationen aus der Freundesliste erlaubt hat. Wenn der Zugriff gewährt wird, können Sie eine Liste von Player-Objekten abrufen, die den Freunden des authentifizierten Spielers entsprechen.
  • Ansicht des Play Spiele-Profils eines anderen Spielers starten: Sie können diese Ansicht öffnen, um den Namen des anderen Spielers anzuzeigen, der vom authentifizierten Spieler angegeben wurde. Diese Ansicht bietet auch Steuerelemente für die Freundschaftsverwaltung und der Spieler wird nicht aus Ihrem 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 können Sie eine Liste der Play Spiele-Freunde Ihrer 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 Ihrem Spiel hinzufügen

Fügen Sie einer vorhandenen In-Game-Freundesliste Play Spiele-Freunde hinzu, indem Sie ihre Play Spiele-ID mit den entsprechenden Spielerinformationen in Ihrer internen Datenbank verknüpfen. Achten Sie darauf, dass neben diesen Freunden eine Schaltfläche mit dem Play Spiele-Symbol angezeigt wird, die beim Drücken das Profil des anderen Spielers öffnet, damit Ihre Nutzer wissen, wer die Freunde sind.

Wenn Sie die Freundesliste von einem Backend-Server verwenden, laden Sie sie sicher über die REST API und nicht über das Ergebnis der Android API. Verwenden Sie in der REST API für den aktuell authentifizierten 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 Ihr 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. Sie könnten beispielsweise eine Schaltfläche mit dem Namen Play Spiele-Freunde importieren hinzufügen, die den Nutzer beim Tippen um die Einwilligung bittet. Verwenden Sie das Play Spiele-Logo auf allen Schaltflächen, auf denen der Dienst erwähnt wird.

Profil eines anderen Spielers ansehen

Sie können Ihrem authentifizierten Spieler erlauben, das Play Spiele-Profil eines anderen Spielers aufzurufen. So kann der authentifizierte Spieler den Namen sehen, den er dem anderen Spieler gegeben hat, und ob sie bereits befreundet sind. Das gibt ihm zusätzlichen Kontext über die Beziehung. Wenn die Spieler noch nicht befreundet sind, werden dem authentifizierten 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 können Sie das Ranking des aktuellen Spielers unter seinen Play-Spiele-Freunden anzeigen. Das gilt nur für Nutzer, die diese Informationen für Ihre 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 finden Sie im Abschnitt Öffentliche und soziale Bestenlisten.

Wenn Sie die Erfassung von Social Leaderboards implementieren, 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 Sie die von Play Spiele bereitgestellte Standard-Benutzeroberfläche implementieren (z. B. getLeaderboardIntent()), wird dies automatisch für Sie erledigt.

Nächste Schritte

Bevor Sie die Friends APIs verwenden, müssen Sie Folgendes tun: