Freunde

Mit den Freunde-APIs kannst du dein bestehendes In-Game-Freundessystem und andere soziale Systeme, auf die dein Spiel zugreifen kann, ergänzen und verbessern. Dadurch haben Sie folgende Möglichkeiten:

  • Finde Freunde in deinem Spiel.

  • Vergleichen Sie Ergebnisse mit ihren Freunden in Bestenlisten.

  • Kombinieren Sie die Liste der Play Spiele-Freunde mit vorhandenen Listen im Spiel.

  • Finde einen anderen Spieler mithilfe eines In-Game-Profil-Pop-ups. Dieses Pop-up zeigt einen Alias, den der aktuelle Spieler seinem Freund gegeben hat, damit er weiß, mit wem er spielt.

Freunde importieren

Grundlagen

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 die Freundesliste erlaubt 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 starten: Sie können diese Ansicht öffnen, um den Namen des anderen Spielers anzuzeigen, der vom angemeldeten Spieler angegeben wurde. Diese Ansicht bietet auch Steuerelemente für das Freundschaftsmanagement, die den Spieler nicht aus dem Spiel nehmen.
  • Steuerelemente für Nutzer bereitstellen: Der Nutzer kann festlegen, wie sein Play Spiele-Profil für Freunde und wie seine Freundesliste für Spiele sichtbar ist. Für den Zugriff auf die Freundesliste kann der Nutzer automatisch Zugriff für alle Spiele gewähren oder ihn für jedes Spiel einzeln genehmigen. Wenn Sie die Freundesliste laden, kann das Ergebnis ein Callback zur Anzeige einer Zugriffsanfrage sein.

Play Spiele-Freundesliste importieren

Mit den Friends APIs kannst du eine Liste der Play Spiele-Freunde deiner Spieler abrufen und sie deiner 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 eine In-Game-Liste von Freunden importieren. Dadurch haben Ihre Nutzer die größtmögliche Anzahl von Spielern, mit denen sie spielen oder gegen sie antreten können.

Füge deinem Spiel Play Spiele-Freunde hinzu

Du kannst Play Spiele-Freunde zu einer Liste mit vorhandenen In-Game-Freunden hinzufügen, indem du ihre Play Spiele-ID mit den entsprechenden Spielerinformationen in deiner internen Datenbank verknüpfst. Neben diesen Freunden muss eine Schaltfläche mit dem Play Spiele-Symbol vorhanden sein, damit das Profil des anderen Spielers angezeigt wird, wenn der Nutzer darauf klickt.

Wenn Sie die Freundesliste von einem Back-End-Server verwenden, laden Sie sie sicher mit der REST API, anstatt das Ergebnis der Android API zu übergeben. Achte darauf, die Spieler-ID zu verwenden, die von players.get(me) in der REST API für den aktuell angemeldeten Spieler zurückgegeben wird. Dies entspricht der ID, die andere Spieler sehen.

Wenn die erweiterte Freundesliste nicht gespeichert, sondern nur zum Zeitpunkt der Ansicht verwendet wird, sind keine zusätzlichen Schritte erforderlich.

Zugriff auf Play Spiele gewähren

Wenn dein Spiel noch keinen Play Spiele-Zugriff hat, kannst du Nutzer, die deine In-Game-Kontaktliste aufrufen, um ihre Zustimmung bitten. Du kannst beispielsweise eine Schaltfläche namens Play Spiele-Freunde importieren hinzufügen, die den Nutzer nach dem Antippen zur Einwilligung auffordert. Achten Sie darauf, das Play Spiele-Logo auf jeder Schaltfläche zu verwenden, auf der der Dienst erwähnt wird.

Profil eines anderen Spielers ansehen

Sie können Ihrem angemeldeten Spieler erlauben, sich das Play Spiele-Profil eines anderen Spielers anzusehen. So kann der angemeldete Spieler den Namen des anderen Spielers sehen und sehen, ob er bereits befreundet ist. So erhält er zusätzlichen Kontext zur Beziehung. Wenn die Spieler noch keine Freunde sind, kann der angemeldete Spieler in der Profilansicht Steuerelemente für die Freundschaftsverwaltung sehen. Wenn innerhalb des Spiels Freundschaften erstellt werden, sind die Standardnamen für die beiden Spieler die In-Game-Namen (falls angegeben). Außerdem wird der Name des Spiels angezeigt, in dem die Freundschaft initiiert wurde.

Profil eines anderen Spielers ansehen

Bestenlisten für soziale Netzwerke

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

Freunde in einer Bestenliste

Wenn Sie die Sammlung für Bestenlisten für soziale Netzwerke implementieren, gibt der Aufruf zum Laden der Bestenlisten-Werte möglicherweise eine Ausnahme mit einer erforderlichen Auflösungslösung wie loadFriends() zurück. Wenn Sie die von Play Spiele bereitgestellte Standardbenutzeroberfläche implementieren (z. B. getLeaderboardIntent()), erfolgt dies automatisch.

Nächste Schritte

Bevor Sie die Friends APIs verwenden, gehen Sie so vor: