Anmeldung

Durch die Anmeldung in den Play-Spieldiensten erhalten Sie die Gaming-Identität eines Spielers. Dies ist eine plattformspezifische, Gaming-spezifische Identität für Android-Spieler. Diese Identität trägt zum Aufbau einer Beziehung zwischen deinem Spiel und dem Spieler bei. Spieler verwenden diese Identität eher zur Anmeldung als für alternative Zentralsysteme.

Außerdem erhalten Sie durch die Anmeldung eine starke, konsistente Kennung, die Sie als Schlüssel für ein Cloud-Speichersystem verwenden können. Cloud-Speicher haben einen hohen Wert und bieten Spielern folgende Möglichkeiten:

• Dort weitermachen, wo sie aufgehört haben, wenn sie ihr Gerät wechseln oder zurücksetzen
• Das Spiel auf mehreren Geräten spielen, z. B. auf einem anderen Smartphone oder Chromebook
• Spiel deinstallieren und später neu installieren

Sie können die Play-Spieldienste-Identität als Schlüssel für Ihre eigene Cloud-Speicherlösung oder den kostenlosen Gespeicherte Spiele-Dienst verwenden.

Die Play-Spieldienste (PGS) unterstützen die automatische Anmeldung, eine reibungslose Anmeldung bei Spielern sowie die manuelle Anmeldung mit nur einem Klick. In diesem Dokument werden diese verschiedenen Anmeldemethoden beschrieben.

Empfohlener Anmeldevorgang

So melden Sie Spieler erfolgreich in Ihrem Spiel an:

1. Versuchen Sie während der Startsequenz Ihres Spiels, die automatische Anmeldung zu verwenden, um den Spieler automatisch anzumelden.
2. Wenn die automatische Anmeldung nicht funktioniert und das Gerät des Nutzers online ist, können Sie die manuelle Anmeldung ausprobieren.
3. Wenn die manuelle Anmeldung abgelehnt wird, speichern Sie die Auswahl des Nutzers und zeigen Sie die manuelle Anmeldung nicht mehr an. Fahren Sie mit dem automatischen Log-in beim Start fort.

Außerdem sollten Sie dafür sorgen, dass sich Nutzer mit ihrem Play Spiele-Dienstkonto mit einer eigenen, leicht zu findenden Schaltfläche in Ihrem Spiel anmelden können.

Automatische Anmeldung

Bei der automatischen Anmeldung können sich Nutzer ohne Probleme in Ihrem Spiel anmelden. Wenn dein Spiel verlangt, dass sich der Nutzer anmeldet und die Einstellung für die automatische Anmeldung in der Google Play Spiele App aktiviert ist, erhältst du die PGS-Identitätsdaten des Nutzers und der Nutzer sieht die Anmeldung für PSDs.

Die automatische Anmeldung ist eine Einstellung, die Nutzer selbst steuern können. Nutzer können sich automatisch in allen Spielen anmelden oder jedes Mal gefragt werden.

Manuelle Anmeldung

Wenn sich ein Nutzer nicht automatisch im Spiel anmeldet, können Sie ihn bitten, sich manuell anzumelden. Nutzer können sich mit einem Klick über ein Dialogfeld anmelden, das über Ihrem Spiel angezeigt wird.

PGS-Pop-ups für die richtige Anmeldung zulassen

Wenn Sie PGS verwenden, müssen die Nutzer wissen, dass sie angemeldet sind. Dazu wird die Anmeldung für PSD angezeigt.

Rufen Sie zum Anzeigen der Anmeldung die Methode setViewForPopups() der Klasse GamesClient beim Starten des Spiels auf. Dies ist wichtig, um die richtige Nutzererfahrung zu ermöglichen.

OAuth-Bereiche und PGS

PGS nutzt das OAuth-System, damit Nutzer deinem Spiel Zugriff auf ihr Konto gewähren können. OAuth-Bereiche sind Berechtigungen, die Sie als Entwickler anfordern können. Wenn du diese Berechtigungen erteilst, kann dein Spiel bestimmte APIs im Namen des Nutzers aufrufen und dir Zugriff auf bestimmte Bereiche seines Google-Kontos gewähren.

PGS hat einen eindeutigen Bereich für Spiele (games-lite) und einen anderen Bereich (drive.app_data), wenn das Spiel die Funktion „Gespeicherte Spiele“ verwendet. Mit der gespeicherten Spielfunktion haben Sie Zugriff auf das Google Drive-Konto des Nutzers, in dem die Spieldaten gespeichert sind.

Ihr Spiel kann jeden Bereich anfordern, den Sie benötigen, um ein hervorragendes Spielerlebnis für Ihre Nutzer zu schaffen. Ihr Spiel kann alle benötigten Bereiche in einem Bundle anfordern, wodurch die Anzahl der Anfragen für den Zugriff auf das Google-Konto begrenzt wird. Dieser Ansatz hat jedoch einen großen Nachteil. Wenn Sie mehr als die PGS-spezifischen Bereiche anfordern, ist die automatische Anmeldung nicht erfolgreich. Die automatische Anmeldung ist die beste Möglichkeit, Spieler in dein Spiel anzumelden.

Es empfiehlt sich, inkrementelle Bereichsanfragen zu verwenden. Ihr Spiel sollte in der ersten Anfrage zuerst nur für PGS-Bereiche anfordern und in einem relevanteren Moment andere Bereiche separat anfordern.

Der OAuth-Zugriff wird über einen anderen Bildschirm für jeden Bereich gewährt. So können Nutzer detailliert entscheiden, welchen Bereichen sie Zugriff gewähren möchten. Wenn Sie die automatische Anmeldung nur mit PGS-Bereichen verwenden, müssen Nutzer nicht mit OAuth-Aufforderungen interagieren, um die Anmeldung zu vereinfachen.

Unterstützung für Mehrfachanmeldungen

PGS bietet Android-Spielern eine Gaming-Identität, sie ist aber nicht die einzige, die mit deinen Nutzern verbunden ist. Du kannst dich gleichzeitig mit Spielern, einer Social-Network-ID und deinem eigenen In-Game-ID-System anmelden. Jedes System bietet einen Mehrwert für dich und deine Spieler und alle können zusammenarbeiten, um Android-Spielern ein hervorragendes Spielerlebnis zu bieten.

Spieleridentität für die Back-End-Integration sicher abrufen und überprüfen

Sie können einen Server-Authentifizierungscode anfordern, damit Ihr Server über die REST API mit den Berechtigungen des angemeldeten Spielers direkt mit den Servern der Play-Spieldienste kommunizieren kann. Dies ermöglicht den direkten Zugriff auf die Spieler-ID, das Profil und andere Informationen (z. B. Freundesliste, falls autorisiert). Wenn du Spieler-IDs, Freundschafts-IDs oder andere zugehörige Daten in deinem Back-End speicherst, muss diese Methode verwendet werden, um die Möglichkeiten für die geräteseitige Manipulation dieser Felder zu entfernen.

Außerdem ist bei einigen älteren Spielen und Spielern die vom Android SDK für einen Spieler zurückgegebene Spieler-ID möglicherweise nicht dieselbe ID, die andere Spieler sehen, wenn sie diesen Spieler im selben Spiel ansehen. Dies ist besonders relevant, wenn die Freundesliste verwendet wird. Die in der REST API zurückgegebene player_id ist jedoch immer konsistent und entspricht immer der ID, die anderen Spielern angezeigt wird.

Weitere Informationen finden Sie unter Offlinezugriff und in der Dokumentation zur REST API.

Clientimplementierung

Informationen zum Implementieren der Anmeldeunterstützung für Android finden Sie unter Anmeldung in Android-Spiele.