Mit der Recall API können Spiele Play-Spieldienste (PGS) als Ergänzung zu ihren wie Google Log-in und die nahtlose Synchronisierung Spieler Anmeldeinformationen auf allen ihren Geräten, um die Onboarding-Abwanderung zu verringern und die Kundenbindung nach 1 Tag erhöhen. Die API verwaltet Verknüpfungen zwischen dem Play-Spieldienste-Konto (PGS) eines Nutzers und ihre In-Game-Konten verwalten, indem sie Recall-Tokens auf Google-Servern speichern. Hier ist ein Beispielszenario für die Verwendung der Recall API:
Ein Nutzer spielt ein Spiel, bei dem der Entwickler ein Identitätssystem hat, das erfasst werden soll. und nutzt PGS parallel zu anderen Authentifizierungsmethoden, Nutzer in ihr Spiel einzuloggen. In diesem Beispiel ist ein Nutzer in seinem Play-Spieldienste angemeldet. Laura-Konto erstellen und ein In-Game-Konto mit dem Racer94 genannt. Während die Nutzenden das Spiel spielen, der Spieleserver des Entwicklers seinen Fortschritt synchronisiert.
Davon abgesehen speichert der Entwickler ein Recall-Token bei Google, das dem In-Game-Konto des Nutzers entspricht. Google speichert automatisch das Token mit dem Play-Spieldienste-Profil des Nutzers zurückruft.
Der Nutzer entscheidet sich nun dafür, das Spiel bei Google Play Spiele auf PC für den ersten . Der Nutzer wird automatisch mit seinem Play-Spieldienste-Konto angemeldet und der Der Spieleclient prüft, ob für diese Spieldienste ein Fortschritt verfügbar ist Nutzer. Der Spieleserver fragt dann bei Google nach, ob Tokens für dieses Play-Spieldienste-Konto. In diesem Fall sendet Google das Recall-Token zurück Der Spieleserver verwendet dieses Token, um das verknüpfte Konto des Nutzers zu finden. Racer94 und stellen ihren Fortschritt wieder her. Die Anmeldung über PGS ist ein reibungslos funktioniert, wird der Fortschritt des Nutzers über die App wiederhergestellt, wenn der Nutzer einen Nutzernamen oder ein Passwort eingeben muss. Darüber hinaus hat der Entwickler können die Anmeldung in Play-Spieldiensten mit ihrem bestehenden Identitätssystem verwenden und Google um die Verknüpfung zwischen dem Spielerfortschritt und seinem Play-Spieldienste-Konto zu speichern.
Wie im obigen Beispiel zu sehen ist, gibt es zwei Hauptaktionen, die von der Recall API:
- Speichern des Tokens bei Google, wenn sich ein Nutzer mit einem der In-Game-Artikel anmeldet Konten.
- Abrufen des Tokens für einen Nutzer, um sein In-Game wiederherzustellen Konten.
Neben Recall-Tokens benötigt die Recall API auch eine stabile ID die dem In-Game-Konto entsprechen, also der Identität, Kardinalitätseinschränkungen. Vielleicht fällt Ihnen eine Persona ein, als Label, das das In-Game-Konto des Nutzers im Identitätssystem und das Recall-Token als Schlüssel für die Wiederherstellung des über das In-Game-Konto des Nutzers mit dem Spiel verknüpft. Persona- und Tokenwerte dürfen nicht wiederverwendet werden auf verschiedenen PGS-Projekte Auch wenn sich Recall-Tokens im Laufe der Zeit ändern können, sollte eine Persona stabil sein. je nach In-Game-Konto des Nutzers.
Kardinalitätsregeln
Die Recall API erzwingt eine 1:1-Beziehung zwischen PGS-Profilen und In-Game-Spielen. (auch als Kardinalitätsregeln bezeichnet), bei denen eine Persona nur ist mit einem Play-Spieldienste-Profil verknüpft und ein Play-Spieldienste-Profil kann jeweils nur mit einem Persona. Die Persona wird als stabile Kennung für ein In-Game-Konto verwendet. da sich Recall-Tokens im Laufe der Zeit ändern können.
Die mit einem Play-Spieldienste-Profil verknüpfte Persona kann sich auch im Laufe der Zeit ändern, da die mit dem Play-Spieldienste-Profil verknüpft sind.
Detaillierte technische Abläufe zum Speichern und Recall-Tokens abrufen
In diesem Abschnitt geht es um den technischen Ablauf zwischen Spieleclient, Gameserver, und den Google-Servern verwenden, wenn Sie Recall-Tokens speichern und abrufen:
Schritt 1: Im Play-Spieldienste-Nutzer anmelden und die Sitzungs-ID abrufen
Das Spiel initialisiert das PGS SDK und versucht, den Nutzer über die Play-Spieldienste anzumelden.
Fordern Sie unter der Voraussetzung, dass der Nutzer angemeldet ist, eine Sitzungs-ID vom Games SDK auf der Spieleclient und fordern ein OAuth 2.0-Token vom OAuth-Back-End von Google an. Die Sitzungs-ID und OAuth-2.0-Tokens werden für die Kommunikation mit den Google Games Back-End.
Schritt 2: Verfügbares Recall-Token abrufen
Fordere ein verknüpftes Recall-Token mit dem Konto des Play-Spieldienste-Nutzers an. Wenn ein Token vorhanden ist, fahren Sie mit Schritt 3a fort und stellen Sie den Fortschritt wieder her. Wenn es sich um einen neuen Nutzer handelt und er kein Token hat, fahre mit dem Schritt 3b und speichern Sie ein neues Token.
Schritt 3a: Wenn ein Token vorhanden ist, den Fortschritt wiederherstellen
Wenn ein Token vorhanden ist, rufen Sie es ab und entschlüsseln Sie es sowie die Nutzerdaten wieder.
Schritt 3b: Wenn kein Token vorhanden ist, Token speichern
Da kein Token vorhanden ist, wird kein Fortschritt wiederhergestellt. Der Nutzer meldet sich an. mit dem Identitätssystem des Entwicklers verknüpft oder erstellt ein neues Konto, falls keine existieren.
ein verschlüsseltes Recall-Token erstellen, das das In-Game-Konto des Nutzers codiert, und zusammen mit der Sitzungs-ID und dem OAuth 2.0-Token an Google senden. An dieser Stelle Google erstellt eine Verknüpfung zwischen dem gesendeten Recall-Token und dem mit dem Play-Spieldienste-Konto des Spielers.
Abläufe für Nutzer ohne Play-Spieldienste-Profil
Du kannst Recall-Tokens für einen Nutzer speichern, der noch kein Play-Spieldienste-Profil erstellt hat: im profillosen Modus. Es gibt jedoch zwei wichtige Einschränkungen:
- Du kannst keine Tokens für einen Nutzer abrufen, der kein Play-Spieldienste-Profil hat. Profil wird automatisch erstellt, wenn der Nutzer versucht, sich in deinem Spiel anzumelden. mit den Play-Spieldiensten auf einem zweiten Gerät.
- Du musst zusätzliche Richtlinien einhalten
damit Sie einen entsprechenden Hinweis erhalten, in dem die folgenden Punkte und
Einholen der erforderlichen Endnutzereinwilligung:
<ph type="x-smartling-placeholder">
- </ph>
- Ihre Freigabe der Daten für Google, um das Play Spiele-Konto zu aktivieren verknüpft werden soll.
- Verfügbarkeit von Einstellungen zum Verwalten dieser Freigabe, z. B. Play Spiele Einstellungen.
- Die Verarbeitung solcher Daten gemäß der Datenschutzerklärung von Google Richtlinien:
Token- und Persona-Paar speichern
- Ein Nutzer ohne Play-Spieldienste-Profil öffnet ein Spiel, das sich an profillose Erinnerungen erinnert aktiviert.
- Das Games SDK löst eine automatische Anmeldung aus, die fehlschlägt, weil der Nutzer Kein Play-Spieldienste-Profil.
- Das Games SDK zeigt eine Snackbar, die den Nutzer darüber informiert, dass das Spiel Google-Integration. Diese Snackbar ist entscheidungsrelevant – der Nutzer kann sie deaktivieren. bis ein Profil erstellt ist.
- Das Spiel fordert Recall-Zugriff an. Beachte, dass die Play-Spieldienste die Rückrufanfragen ablehnen wenn auf dem Gerät Play-Spieldienste-Profile vorhanden sind oder Konten auf dem Gerät In diesem Fall sollte das Spiel ohne Play-Spieldienste
- Nachdem sich der Nutzer mit einem In-Game-Konto angemeldet hat, erstellt das Spiel ein Token und Persona-Paar für den Nutzer, das seinem In-Game-Konto entspricht. Das Spiel speichert dieses Paar bei Google. Das Spiel kann später weitere Tokens speichern, sich der Nutzer in anderen In-Game-Konten anmeldet.
Spiel auf einem neuen Gerät starten
- Ein Nutzer ohne Play-Spieldienste-Profil öffnet ein Spiel, für das die profillose Erinnerung aktiviert ist auf einem Gerät.
- Das Spiel zeichnet ein profilloses Recall-Token auf, wie unter Token speichern und Persona-Paar.
- Der Nutzer öffnet dasselbe Spiel auf einem anderen Gerät mit demselben Konto. einrichten.
- Das Games SDK löst die Profilerstellung aus. Der Nutzer kann prüfen und ablehnen. zuvor gespeicherten Recall-Tokens. Der Nutzer erstellt zu diesem Zeitpunkt ein Play-Spieldienste-Profil.
- Die automatische Anmeldung in den Play-Spieldiensten ist abgeschlossen und das Spiel erhält Authentifizierungsstatus.
- Das Spiel ruft wie gewohnt Recall-Tokens für den Nutzer ab.
Nächste Schritte
Um die Recall API in deinen Client und Gameserver zu integrieren, diesem Implementierungsleitfaden.