Freunde

Mit den Friends APIs können Sie Ihr bestehendes In-Game-Freundesystem und andere soziale Systeme, auf die Ihr Spiel zugreifen kann, ergänzen und verbessern. So können Sie Spielern Folgendes ermöglichen:

  • Sie können die Freunde in Ihrem Spiel finden.

  • Sie können ihre Punktzahl mit der ihrer Freunde auf Bestenlisten vergleichen.

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

  • Einen anderen Spieler über ein Pop-up-Profil im Spiel 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 erlaubt hat, auf Informationen in der Freundesliste zuzugreifen. Wenn der Zugriff gewährt wird, kannst du eine Liste der Spielerobjekte abrufen, die den Freunden des angemeldeten Spielers entsprechen.
  • Play Spiele-Profil eines anderen Spielers aufrufen: In dieser Ansicht wird der Name angezeigt, den der angemeldete Spieler dem anderen Spieler gegeben hat. In dieser Ansicht können Sie auch Freundschaften verwalten und der Spieler wird nicht aus dem Spiel entfernt.
  • Nutzereinstellungen bereitstellen: Nutzer können festlegen, wie ihr Play Spiele-Profil für Freunde und wie ihre Freundesliste für Spiele sichtbar ist. Für den Zugriff auf die Freundesliste kann der Nutzer festlegen, ob der Zugriff für alle Spiele automatisch gewährt werden soll, oder den Zugriff für jedes Spiel einzeln genehmigen. Beim Laden der Freundesliste kann es daher zu einem Callback kommen, 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 Ihrer In-Game-Freundesliste hinzufügen.

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

Ihrem Spiel Play-Spieldienste hinzufügen

Sie können Play Spiele-Freunde einer vorhandenen In-Game-Freundesliste hinzufügen, indem Sie ihre Play Spiele-ID mit den entsprechenden Spielerinformationen in Ihrer internen Datenbank verknüpfen. Neben diesen Freunden muss eine Schaltfläche mit dem Play Spiele-Symbol angezeigt werden, über die das Profil des anderen Spielers aufgerufen werden kann. So können Ihre Nutzer sehen, wer die Freunde sind.

Wenn du die Freundesliste von einem Backend-Server verwendest, lade sie über die REST API sicher, anstatt das Ergebnis der Android API zu übergeben. Verwende die von players.get(me) zurückgegebene Spieler-ID in der REST API für den aktuell angemeldeten Spieler, da diese mit der ID übereinstimmt, die andere Spieler sehen.

Wenn die erweiterte Freundesliste nicht gespeichert, sondern nur zum Zeitpunkt der Wiedergabe verwendet wird, sind keine weiteren Maßnahmen erforderlich.

Play Spiele Zugriff gewähren

Wenn Ihr Spiel noch keinen Zugriff auf Google Play Spiele hat, ist es sinnvoll, Nutzer um ihre Einwilligung zu bitten, wenn sie sich die Freundesliste im Spiel ansehen. Sie können beispielsweise die Schaltfläche Google Play-Freunde importieren hinzufügen, über die der Nutzer um seine Einwilligung gebeten wird. 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 Nutzer erlauben, das Play Spiele-Profil eines anderen Nutzers aufzurufen. So kann der angemeldete Spieler den Namen sehen, den er dem anderen Spieler gegeben hat, und ob sie bereits befreundet sind. Wenn die Spieler noch keine Freunde sind, sieht der angemeldete Spieler in der Profilansicht die Einstellungen für die Freundschaftsverwaltung. Wenn Freundschaften direkt im Spiel erstellt werden, sind die Standardnamen der beiden Spieler ihre In-Game-Namen (falls angegeben). Außerdem wird der Name des Spiels angezeigt, in dem die Freundschaftsanfrage gesendet wurde.

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 das Ranking des aktuellen Spielers unter seinen Play Spiele-Freunden anzeigen. Hinweis: Dies gilt nur für Nutzer, die sich entschieden haben, diese Informationen für Ihre App freizugeben, und nur, wenn die Nutzer in Play Spiele befreundet sind. Um diese Funktion zu unterstützen, stellt das Spiel dem Nutzer eine Steuerelement zur Verfügung. Bei diesem Steuerelement wird das Argument collection verwendet, um die Ansicht „Soziale Netzwerke“ der Bestenliste auszuwählen. Weitere Informationen finden Sie im Abschnitt zu öffentlichen und sozialen Bestenlisten.

Wenn Sie die Sammlung „Social Leaderboards“ implementieren, kann der Aufruf zum Laden der Leaderboard-Punkte eine Einwilligungspflichtige Auflösungsausnahme zurückgeben, die der von loadFriends() ähnelt. Wenn Sie die standardmäßige Benutzeroberfläche von Google Play Spiele implementieren (z. B. getLeaderboardIntent()), wird dies automatisch für Sie erledigt.

Nächste Schritte

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