Die Anmeldung über die Play-Spieldienste bietet Ihnen die Gaming-Identität eines Spielers. Das ist eine plattformspezifische Gaming-Identität für Android-Spieler. Diese Identität trägt dazu bei, eine Beziehung zwischen Ihrem Spiel und den Spielern aufzubauen. Spieler sind eher bereit, sich mit dieser Identität anzumelden als mit alternativen zentralen Systemen.
Darüber hinaus erhalten Sie durch die Anmeldung eine starke, konsistente Kennung, die Sie als Schlüssel für ein Cloud-Speichersystem verwenden können. Cloud-Speicher ist sehr beliebt, da er Spielern Folgendes ermöglicht:
- 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 einem Chromebook)
- Spiel deinstallieren und später neu installieren
Sie können die Identität der Play Spiele-Dienste als Schlüssel für Ihre eigene Cloud-Speicherlösung verwenden oder den kostenlosen Dienst „Gespeicherte Spiele“ nutzen.
Play-Spieldienste (PGS) unterstützen die automatische Anmeldung, eine reibungslose Möglichkeit, Spieler anzumelden, sowie die manuelle Anmeldung, die nur einen Klick erfordert. In diesem Dokument werden diese verschiedenen Anmeldemethoden beschrieben.
Empfohlener Anmeldevorgang
Verwenden Sie für die Anmeldung von Spielern in Ihrem Spiel den folgenden Anmeldevorgang:
- Wenn du möchtest, dass sich der Spieler beim Starten deines Spiels automatisch anmeldet, verwende die Option Automatische Anmeldung.
- Wenn die automatische Anmeldung nicht funktioniert und das Gerät des Nutzers online ist, versuchen Sie es mit der manuellen Anmeldung.
- Wenn die manuelle Anmeldung abgelehnt wird, wird die Auswahl des Nutzers gespeichert und die manuelle Anmeldung wird nicht noch einmal angezeigt. Die automatische Anmeldung wird jedoch weiterhin beim Start versucht.
Außerdem sollten Nutzer sich über eine eigene, leicht zu findende Schaltfläche mit ihrem Play-Spieldienstkonto in Ihrem Spiel anmelden können.
Automatische Anmeldung
Mit der automatischen Anmeldung können sich Nutzer ganz einfach in Ihrem Spiel anmelden – ganz automatisch! Wenn in Ihrem Spiel die Anmeldung des Nutzers angefordert wird und die Einstellung für die automatische Anmeldung in der Google Play Spiele App aktiviert ist, erhalten Sie die Anmeldedaten des Nutzers für Play-Spieldienste und der Nutzer wird zur Anmeldung in Play-Spieldiensten weitergeleitet.
Die automatische Anmeldung ist eine Einstellung, die Nutzer selbst verwalten können. Nutzer können festlegen, ob sie sich automatisch in allen Spielen anmelden oder jedes Mal gefragt werden möchten.
Manuelle Anmeldung
Wenn sich ein Nutzer nicht automatisch im Spiel anmeldet, kannst du ihn bitten, sich manuell anzumelden. Nutzer können sich über ein Dialogfeld oben in Ihrem Spiel mit nur einem Klick anmelden.
Pop-ups für Play-Spieldienste zulassen, um die richtige Anmeldung zu ermöglichen
Wenn Nutzer die Play-Spieldienste verwenden, müssen sie wissen, dass sie angemeldet sind. Dazu wird die PGS-Anmeldeoberfläche angezeigt.
Rufen Sie zum Anzeigen der Anmeldung die Methode setViewForPopups()
der Klasse GamesClient
beim Start des Spiels auf. Das ist entscheidend für eine
richtige User Experience.
OAuth-Bereiche und Play-Spieldienste
PGS nutzt das OAuth-System, damit Nutzer Ihrem Spiel Zugriff auf ihr Konto gewähren können. OAuth-Bereiche sind Berechtigungen, die Sie als Entwickler anfordern können. Wenn diese Berechtigungen gewährt werden, kann Ihr Spiel bestimmte APIs im Namen des Nutzers aufrufen und Sie erhalten Zugriff auf bestimmte Teile seines Google-Kontos.
PGS hat einen speziellen Bereich für Spiele (games-lite
) und stützt sich auf einen anderen Bereich (drive.appdata
), wenn dein Spiel die Funktion „Gespeicherte Spiele“ verwendet. Die Funktion „Gespeicherte Spiele“ bietet Zugriff auf das Google Drive-Konto des Nutzers, in dem die Spieldaten gespeichert sind.
Ihr Spiel kann jeden Umfang anfordern, den Sie benötigen, um ein hervorragendes Spielerlebnis für Ihre Nutzer zu schaffen. Ihr Spiel kann alle erforderlichen Bereiche in einem Paket anfordern, wodurch die Anzahl der Anfragen für den Zugriff auf das Google-Konto begrenzt wird. Dieser Ansatz hat jedoch auch einen großen Nachteil. Wenn Sie mehr als die PGS-spezifischen Bereiche anfordern, kann die automatische Anmeldung nicht erfolgreich sein. Die automatische Anmeldung ist die beste Möglichkeit, Spieler in Ihrem Spiel anzumelden.
Es empfiehlt sich, Anfragen mit inkrementellem Umfang zu verwenden. Ihr Spiel sollte in der ersten Anfrage zuerst nur PGS-Bereiche anfordern und andere zu einem relevanteren Zeitpunkt separat anfordern.
Der OAuth-Zugriff wird für jeden Bereich in einem anderen Bildschirm gewährt. So können Nutzer genau festlegen, für welche Bereiche Zugriff gewährt werden soll. Wenn Sie die automatische Anmeldung nur mit PGS-Umfängen verwenden, müssen Nutzer nicht mit OAuth-Aufforderungen interagieren, was die Anmeldung erleichtert.
Unterstützung von Mehrfach-Anmeldemethoden
Die Play-Spieldienste stellen eine Gaming-Identität für Android-Nutzer bereit. Sie muss aber nicht die einzige Identität sein, die mit Ihren Nutzern verknüpft ist. Sie können Spieler gleichzeitig über die Play-Spieldienste, eine ID in einem sozialen Netzwerk und Ihr eigenes In-Game-ID-System anmelden. Jedes System bietet sowohl Ihnen als auch Ihren Spielern einen einzigartigen Mehrwert. Sie können alle Systeme kombinieren, um Android-Spielern ein optimales Spielerlebnis zu bieten.
Spieleridentität für die Backend-Integration sicher abrufen und bestätigen
Sie können einen Serverautorisierungscode anfordern, damit Ihr Server mit der Autorisierung des angemeldeten Spielers direkt über die REST API mit den Servern der Play-Spieldienste kommunizieren kann. Dadurch erhältst du direkten Zugriff auf die ID, das Profil und andere Informationen des Spielers, z. B. die Freundesliste, falls autorisiert. Wenn Sie Spieler-IDs, Freundes-IDs oder andere zugehörige Daten in Ihrem Back-End speichern, muss diese Methode verwendet werden, um die Möglichkeit einer geräteseitigen Manipulation dieser Felder zu eliminieren.
Bei einigen älteren Spielen und Spielern entspricht die vom Android SDK zurückgegebene Spieler-ID möglicherweise nicht der ID, die andere Spieler sehen, wenn sie sich diesen Spieler im selben Spiel ansehen. Dies ist besonders relevant, wenn die Freundesliste verwendet wird. Die player_id
, die über die REST API zurückgegeben wird, ist jedoch immer konsistent und entspricht immer der ID, die andere Spieler sehen.
Weitere Informationen finden Sie unter Offlinezugriff und in der Dokumentation zur REST API.
Client-Implementierung
Informationen zum Implementieren der Anmeldungsunterstützung unter Android finden Sie unter Anmeldung in Android-Spielen.