Nahtlose Wiederherstellung

Seamless Restore ist eine Funktion der Google Play-Spieledienste, mit der Spieler, die ein Spiel auf einem neuen Gerät installieren oder es neu installieren, sofort wieder an ihren bisherigen Spielfortschritt anknüpfen können. So wird der Anmeldebildschirm umgangen.

Seamless Restore ist eine empfohlene Richtlinie für das Level Up-Programm.

Mit der Authentifizierung über die Google Play-Spieldienste können Sie die Plattformauthentifizierung für Nutzer Ihres Spiels optimieren. Initialisieren Sie das Play Games Services SDK, um die Authentifizierung auszulösen. Dadurch ist kein separater Vorgang für die Plattformauthentifizierung erforderlich.

Nutzerkonten verknüpfen, um Kontinuität und geräteübergreifende Wiedergabe zu ermöglichen

Spieler nutzen ihre Lieblingsspiele auf einer Vielzahl von Geräten und Plattformen, darunter Smartphones, Tablets und PCs. Ein wichtiger Wunsch dieser Spieler ist die Möglichkeit, ihr Gameplay nahtlos genau dort fortzusetzen, wo sie aufgehört haben, unabhängig vom gewählten Gerät.

Eine erhebliche Barriere, die oft dazu führt, dass Nutzer die Nutzung abbrechen, ist die Notwendigkeit, sich auf jedem neuen Gerät separat anzumelden. Nutzer möchten sofort in das Spiel eintauchen, ohne unnötige Unterbrechungen.

Damit das Spiel nahtlos fortgesetzt und auf verschiedenen Geräten gespielt werden kann, müssen Sie zwei wichtige Funktionen implementieren:

Der Authentifizierungsprozess der Play-Spieldienste bietet flexible Optionen für Spieler-IDs. Mit diesen Optionen können Sie die Play-Spieldienste in Ihre eigene vorhandene Identitätslösung einbinden.

Neue Play-Spieldienste-Integration

Bei Spielen ohne vorhandene Play-Spieldienste-Integration vereinfacht die Recall API die Backend-Einrichtung, da sie Kontoverknüpfungen verwaltet und die Verbindung zwischen dem Spielkonto eines Nutzers und seinem Play-Spieldienste-Konto speichert.

Kontoverknüpfung mit der Recall API

Die Recall API ist die empfohlene Lösung zum Verknüpfen von Nutzerkonten in plattformübergreifenden Spielen. Diese API ist besonders nützlich für Spiele ohne vorhandene Play-Spieldienste-Integration oder für Spiele, die neben den Play-Spieldiensten zusätzliche Lösungen für die Plattformauthentifizierung verwenden.

Die Recall API vereinfacht die Einrichtung des Backends Ihres Spiels, da sie die Kontoverknüpfungen verwaltet.

Vereinfachtes Backend: Die API vereinfacht die Einrichtung des Backends Ihres Spiels für die Kontoverknüpfung.
Von Play verwaltete Verknüpfungen: Play speichert die Verknüpfung zwischen den Spielekonten der Nutzer (einschließlich Konten von Drittanbietern) und ihren Play-Spieldienste-Konten.
Wiederherstellung des Fortschritts: Entwickler generieren und senden Speicherdaten-Tokens an Play, die dann abgerufen werden können, um den Spielfortschritt eines Nutzers wiederherzustellen.

Bei der Implementierung der Recall API müssen Entwickler prüfen, ob Speicherdaten-Tokens undurchsichtige Strings sind. Diese Tokens dürfen keine vertraulichen oder personenidentifizierbaren Informationen über Gamer enthalten, z. B. Name, E‑Mail-Adresse oder demografische Daten.

Spiele müssen beim Generieren von Speicherdaten-Tokens robuste Verschlüsselungsalgorithmen verwenden, um Nutzerdaten zu schützen und die Sicherheit zu gewährleisten.

Weitere Informationen zur Funktionsweise von Recall finden Sie unter Recall API.

Informationen zur Implementierung der Recall API finden Sie unter PGS Recall API in Ihr Spiel einbinden.

Vorhandene Integration der Play Games-Dienste

In diesem Abschnitt wird erläutert, wie Sie Ihr Spiel in Play-Spieldienste einbinden, indem Sie Spielerkonten verknüpfen. Hier erfahren Sie, wie Sie Spieler-IDs verwenden, um authentifizierte Spieler zu identifizieren und mehrere Spielkonten für einen einzelnen Nutzer der Play-Spieldienste zu verwalten.

Mit einer `Player_id` verknüpfen

Eine Spieler-ID ist eine Kennung für ein Play-Spieldienste-Konto. Ihr Spiel kann eine Spieler-ID für jeden Spieler abrufen, der sich über die Play-Spieldienste in Ihrem Spiel authentifiziert hat.

Bei Spielen, deren Backend mit Play-Spieldienste-Player_Id eingerichtet ist, oder bei Spielen, die Unterstützung für minderjährige Nutzer benötigen, sollte Player_Id verwendet und das Spiel und die Drittanbieterkonten mit Player_Id verknüpft werden.

So verhalten sich Spieler-IDs:

Einheitlich innerhalb eines Spiels: Eine Spieler-ID bleibt für einen Nutzer auf mehreren Geräten gleich, wenn er dasselbe Spiel spielt.
Inkonsistent zwischen Spielen: Spieler-IDs sind nicht immer konsistent, wenn ein Nutzer verschiedene Spiele spielt.

Weitere Informationen finden Sie unter Player-IDs der nächsten Generation.

Mehrere Konten pro Nutzer durch Verknüpfung verwalten

Wenn Sie mehrere Nutzerkonten mit einem einzelnen Play-Spieldienste-Konto verknüpfen möchten, erstellen Sie in Ihrer Tabelle eine 1:n-Zuordnung.

Plattformübergreifende Google-Identität mit „Über Google anmelden“

Mit Google anmelden (SiwG) ist die primäre Identitätslösung von Google, mit der Spieleentwickler die Profilinformationen ihrer Spieler sicher abrufen können, z. B. Name, E-Mail-Adresse und Profilbild.

Ein wichtiger Vorteil von „Über Google anmelden“ ist die breite Verfügbarkeit auf verschiedenen Plattformen, darunter Web, Android und iOS. Es bietet eine schnelle, sichere und vertraute Anmeldung, die Spieler bereits kennen und der sie vertrauen.

Mit dem Feld `sub` des Google-ID-Tokens verknüpfen

Um eine nahtlose plattformübergreifende Nutzung zu ermöglichen, können Sie eine Authentifizierungsstrategie implementieren, die das Kontosystem Ihres Spiels mit einer eindeutigen Google-Konto-Kennung verknüpft. Bei diesem Ansatz wird die optimierte Play Games-Dienste-Authentifizierung unter Android genutzt, während auf anderen Plattformen wie iOS und im Web das Standard-SDK für „Mit Google anmelden“ verwendet wird.

Das Feld sub aus dem Google-ID-Token ist eine eindeutige und dauerhafte Kennung für das Konto eines Google-Nutzers. Dieses sub-Feld ist für denselben Nutzer auf allen Plattformen identisch. Verwenden Sie diesen sub-Wert als eindeutigen Schlüssel in Ihrem Backend, um den Spielfortschritt geräteübergreifend zu verknüpfen und wiederherzustellen. Mit diesem Schlüssel werden alle Sitzungen eines Spielers mit einem einzelnen Spielkonto in Ihrem Backend verknüpft.

Allgemeiner Ablauf:

Auf Android-Geräten:Ihr Spiel initialisiert das Play Games Services SDK, um die Plattformauthentifizierung auf Android-Geräten automatisch auszulösen. Wenn Sie sich über Google auf Android anmelden, fordern Sie die drei Anmeldebereiche an: email, profile und openid. Verwenden Sie keine Play Games-Dienste v2-Integration. Dies sind dieselben Bereiche, die von einem Standard-SiwG-SDK angefordert werden. So können Sie ein ID-Token abrufen, das das Feld sub des Spielers enthält.
Im Web und unter iOS:Ihr Spiel verwendet die Standard-SDKs Mit Google anmelden für das Web und Google-Anmeldung für iOS und macOS. Wenn sich der Nutzer anmeldet, stellt das SiwG SDK ein ID-Token bereit, das auch das Feld sub des Nutzers enthält.
Kontoverknüpfung:Da sich der Nutzer auf beiden Plattformen mit demselben Google-Konto anmeldet, ist das Feld sub, das Sie erhalten, identisch. Sie können diesen sub-Wert dann in Ihrer Identitätslösung mit Ihrer internen Nutzer-ID verknüpfen und so eine einheitliche Nutzererfahrung schaffen.

Integration auf Android

Initialisieren Sie auf Android-Geräten das Play Games Services SDK, um die Plattformauthentifizierung automatisch auszulösen. Wenn Sie sich dann mit Google auf Android anmelden, fordern Sie die drei Anmeldebereiche email, profile und openid an. So können Sie einen serverseitigen Autorisierungscode abrufen, den Ihr Backend gegen ein ID-Token eintauschen kann, das die Informationen des Nutzers enthält, einschließlich des eindeutigen Felds sub.

Auf übergeordneter Ebene umfasst die Implementierung Folgendes:

Client-IDs in einem einheitlichen Projekt einrichten:Bevor Sie die Integration vornehmen, müssen Sie die Play Games-Dienste in der Google Play Console einrichten, um Ihre OAuth 2.0-Client-IDs zu erhalten.

Wichtig :Für die plattformübergreifende Verknüpfung muss dieses Google Cloud-Projekt für alle Plattformen verwendet werden. Alle Client-IDs, die Sie später für andere Plattformen (z. B. Web und iOS) erstellen, müssen diesem Projekt hinzugefügt werden.
Play-Spieldienste konfigurieren:Fügen Sie zuerst Ihr Spiel in der Google Play Console hinzu und integrieren Sie die Plattformauthentifizierung der Play-Spieldienste in Ihr Spiel.
Button „Über Google anmelden“ hinzufügen:Fügen Sie auf der Anmeldeseite oder im Bildschirm mit den Nutzereinstellungen Ihres Spiels einen Über Google anmelden-Button hinzu. Durch Klicken auf diese Schaltfläche wird der Anmelde- oder Registrierungsvorgang gestartet. Wenn Sie diese Schaltfläche erstellen, sollten Sie die Branding-Richtlinien für „Mit Google anmelden“ einhalten. Auf der Schaltfläche muss mindestens „Google“ oder „Über Google anmelden“ deutlich zu sehen sein. Über den Link zu den Richtlinien können Sie auch UX-Assets herunterladen, die den Richtlinien entsprechen und in Ihrem Spiel verwendet werden können.
Server-Autorisierungscode mit Anmeldebereichen anfordern:Wenn der Spieler auf die Schaltfläche klickt, fordert Ihr Spiel einen einmaligen Server-Autorisierungscode an. Der wichtigste Schritt ist, diese Anfrage so zu konfigurieren, dass sie die folgenden Anmeldebereiche enthält: EMAIL, PROFILE und OPEN_ID.

Wie Sie dies konfigurieren, hängt von Ihrer Entwicklungsumgebung ab:
- Für Java/Kotlin:Informationen zum Abrufen des Serverautorisierungscodes mit requestServerSideAccess finden Sie in der Anleitung.
- Für Unity:Weitere Informationen finden Sie im Leitfaden zum Abrufen von Autorisierungscodes in Unity.
Authentifizierungscode tauschen und ID-Token im Backend überprüfen:Senden Sie den Authentifizierungscode aus dem vorherigen Schritt an Ihren Backend-Server. Folgen Sie auf dem Server der Anleitung zum standardmäßigen OAuth 2.0-Codeaustauschablauf, um den Code gegen ein ID-Token, ein Zugriffstoken und ein Aktualisierungstoken einzutauschen. Wie im Leitfaden beschrieben, müssen Sie das ID-Token auf Ihrem Server überprüfen.
sub-Feld binden:Wenn das ID-Token erfolgreich bestätigt wurde, extrahieren Sie das sub-Feld aus der Nutzlast. Verwenden Sie diesen sub-Wert als eindeutigen Schlüssel für die Google-Identität in Ihrer Identitätslösung.
- Wenn dieser sub-Wert bereits in Ihrer Datenbank vorhanden ist, hat der Nutzer die Verknüpfung bereits hergestellt. Melden Sie sich in dem entsprechenden Spielkonto an.
- Wenn dieser sub-Wert nicht vorhanden ist, können Sie entweder ein neues Nutzerkonto im Kontosystem Ihres Spiels erstellen, das mit diesem sub verknüpft ist, oder eine Verknüpfung zu einem vorhandenen Nutzerkonto in Ihrem Kontosystem herstellen, indem Sie Nutzerinformationen (z. B. die E-Mail-Adresse) abgleichen, die im ID-Token angegeben sind.

Integration in iOS, Web und andere Plattformen

Auf anderen Plattformen als Android, iOS, Web oder PC verwenden Sie die Standard-SDKs für die Anmeldung mit Google. Das Ziel ist dasselbe wie beim Android-Ablauf: ein Google-ID-Token sicher abrufen, es an Ihr Backend senden und das Feld sub zum Verknüpfen des Kontos verwenden.