Plattformauthentifizierung

Der erste Schritt bei der Integration Ihres Spiels in die Google Play Games-Dienste (PGS) ist die Implementierung der Plattformauthentifizierung. Dies ist erforderlich, um auf alle anderen Funktionen wie Erfolge, Bestenlisten und Events zuzugreifen.

Da das Play Games-Dienste SDK die Plattformauthentifizierung beim Start des Spiels automatisch durchführt, müssen Sie das PGS v2 SDK in Ihr Spiel einbinden und den empfohlenen Authentifizierungsablauf implementieren, damit Ihr Spiel bereit ist, die Richtlinien für die Nutzerfreundlichkeit von Google Play Games Level Up zu implementieren und zu erfüllen.

Konzepte der Authentifizierung

In Play Games-Dienste v2 ist das Konzept der „Anmeldung“ in zwei separate Ebenen unterteilt: Plattformauthentifizierung und Authentifizierung im Spiel.

Plattformauthentifizierung

Play Games-Dienste bieten eine Plattform für die Interaktion. Es verwaltet die Beziehung des Spielers zum Google Play Games-Ökosystem über das Spielerprofil, um auf Funktionen wie Erfolge, Bestenlisten und Quests zuzugreifen. Die Plattformauthentifizierung hat die folgenden wichtigen Merkmale:

• Im Hintergrund und automatisch:Die Authentifizierung erfolgt automatisch im Hintergrund, wenn das Spiel gestartet wird. Für die Play Games-Dienste ist keine manuelle Schaltfläche Anmelden erforderlich.
• Spieler-ID:Nach erfolgreicher Plattformauthentifizierung stellen die Play Games-Dienste eine stabile Spieler-ID bereit. Diese ID ist für dasselbe Spiel auf allen Geräten gleich. Verwenden Sie diese ID in erster Linie, um Plattformfunktionen wie den Fortschritt bei Erfolgen zu erfassen.
• Entkoppelt:Sie dürfen Play Games-Dienste nicht als primäres Identitätssystem Ihres Spiels verwenden, um das In-Game-Konto (IGA) Ihres Spielers, den Spielfortschritt oder das Inventar zu verwalten. Play Games-Dienste dienen als dauerhafter Plattform-Identifier.

Spieler-ID

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 Authentifizierung über die Play Games-Dienste in Ihrem Spiel anmeldet. Ihre Game-Client-Integration, Game-Server-Integration und Cloud-Speicherdienst können die ID verwenden, um sicher auf Spielerdaten aus Play Games-Diensten zuzugreifen.

Eine Spieler-ID bleibt für einen Nutzer gleich, wenn er Ihr Spiel auf mehreren Geräten spielt. Allerdings ist sie nicht immer zwischen den Spielen konsistent. Weitere Informationen finden Sie unter Spieler-IDs der nächsten Generation.

In-Game-Authentifizierung

Sie verwalten das In-Game-Konto (IGA), das das Identitätssystem ist, das den Spielerfortschritt, das Inventar und die Währung in Ihrem Spiel verbindet.

• Primäre Identität:Sie können Ihr eigenes Backend, „Über Google anmelden“ (SiWG) oder andere Anbieter als primäre Anmeldemethode verwenden.
• Unabhängigkeit:Spieler können sich in den Play Games-Diensten (Plattformidentität) anmelden, um Erfolge zu erzielen, während sie in einem beliebigen IGA angemeldet sind, z. B. in einem Gastkonto oder einem bestimmten SiWG-Konto.
• Verwaltung mehrerer IGAs:Die Play Games-Dienste übernehmen nur die Plattformauthentifizierung. Ihr Spiel verwaltet die primäre Authentifizierung von Spielern in ihren IGAs. Das bedeutet, dass sich an den bestehenden Abläufen für Spieler, die zwischen ihren IGAs wechseln möchten, nichts ändert. Wenn Spieler das Konto wechseln, bleiben sie über die Play-Spieldienste bei der Play Games-Plattform authentifiziert. Sie senden ihre Daten zu Erfolgen und anderen Play-Spieldienste-Funktionen weiterhin mit der persistenten Spieler-ID.

Plattformübergreifende Kontinuität mit SiWG

Damit Spieler ihren Fortschritt auf Android-, iOS- und Webplattformen übertragen können, sollten Sie Über Google anmelden als primäre Authentifizierungsmethode im Spiel verwenden. Beachten Sie dabei Folgendes:

• Über Google anmelden:In PGS v1 wurde mit dem Button Google Play oft sowohl die Plattform- als auch die Spielanmeldung abgewickelt. In Version 2 sind das separate Prozesse. Implementieren Sie eine Standard-Schaltfläche Über Google anmelden, damit Spieler sich authentifizieren und auf ihr IGA zugreifen können.
• Google-Anmelde-SDKs:
  • Verwenden Sie für Android und iOS die Standard-SDKs für die Google-Anmeldung, um Spieler in ihren IGAs zu authentifizieren.
  • Verwenden Sie Google Open ID als primäre Kennung für das In-Game-Konto eines Spielers.
  • Verwenden Sie die Spieler-ID der Play Games-Dienste, um den Fortschritt eines Spielers bei Play Games-Funktionen wie Erfolgen zu melden.

Empfohlene Integration

So integrieren Sie Ihr Spiel in die Play Games-Dienste:

Initialisierung und Authentifizierung

Dieser Schritt ist erforderlich, um Ihr Spiel zu initialisieren und zu authentifizieren:

Implementieren Sie die Plattformauthentifizierung, indem Sie das Play Games-Dienste v2 SDK beim Start initialisieren. Weitere Informationen finden Sie unter Plattformauthentifizierung für Android-Spiele. Dieser Schritt ist erforderlich, um auf Play Games-Dienste-Funktionen wie Erfolge und Bestenlisten zuzugreifen.

Die Authentifizierung wird beim Start des Spiels als lautloser Hintergrundprozess ausgeführt. Bestehende Nutzer der Play Games-Dienste sehen nach erfolgreicher Authentifizierung eine Willkommensnachricht. Nutzer ohne Play Games-Dienste-Profil werden bei der SDK-Initialisierung aufgefordert, ein Profil zu erstellen.

Profilerstellung

Spieler benötigen ein Play Games-Dienste-Profil, um die Plattform nutzen zu können. Einige Spieler haben möglicherweise kein Play Games-Dienste-Profil, wenn sie Ihr Spiel starten. Diese Spieler werden aufgefordert, ein Konto zu erstellen.

Aufforderungen zur automatisch ausgelösten Profilerstellung werden standardmäßig automatisch angezeigt, wenn Sie ein Spiel ohne Play Games-Dienste-Profil starten.

In-Game-Authentifizierung

Nachdem die Plattformauthentifizierung erfolgreich ausgeführt wurde, sollten Entwickler die folgenden Schritte implementieren, damit Spieler je nach aktuellem Spielstatus auf ihre IGAs zugreifen können:

1. Wenn auf dem Gerät eine aktive Spielsitzung vorhanden ist, kann der Spieler die aktuelle Sitzung fortsetzen.
2. Wenn keine aktive Spielsitzung vorhanden ist:
   1. Im Fall eines nahtlosen Wiederherstellungsszenarios, in dem ein zuletzt gespieltes IGA mit der PGS-Player-ID verknüpft ist, wird das zugehörige IGA automatisch wiederhergestellt.
   2. Andernfalls präsentieren Sie dem Spieler den für Ihre Anwendung vorgesehenen Anmelde- oder Kontoerstellungsbildschirm. Spieler können dann ihre bevorzugte Authentifizierungsmethode auswählen, um eine IGA zu erstellen oder sich in einer bestehenden IGA anzumelden.

OAuth-Bereiche

Play Games-Dienste nutzen das OAuth-System, damit Spieler Ihrem Spiel Zugriff auf ihr Konto gewähren können. Die Play Games-Dienste haben einen eindeutigen Zugriffsbereich für Spiele (games-lite) und verwenden einen anderen Zugriffsbereich (drive.appdata), wenn Ihr Spiel die Funktion „Gespeicherte Spiele“ nutzt. Die Funktion „Gespeicherte Spiele“ bietet Zugriff auf das Google Drive-Konto des Nutzers, in dem die Spieldaten gespeichert sind.

Wenn Sie das Play Games-Dienste v2 SDK verwenden, können Sie zusätzliche OAuth-Bereiche anfordern. Wenn Sie zusätzliche OAuth-Bereiche benötigen, empfehlen wir, requestServerSideAccess aufzurufen. Weitere Informationen finden Sie unter Server-Autorisierungscode abrufen oder Server-Authentifizierungscodes abrufen.

Richtlinie für die Nutzerfreundlichkeit für den idealen Authentifizierungsablauf

In den folgenden Richtlinien wird der empfohlene Authentifizierungsablauf bei der Integration von PGS v2 beschrieben. Sie decken Szenarien für neue, bestehende und wiederkehrende Nutzer sowie den Gastmodus ab.

Neuer Spieler

Dieser Ablauf gilt für Nutzer, die das Spiel zum allerersten Mal auf einem Gerät starten, auf dem es noch nicht gespielt wurde.

1. Beim Start wird das PGS SDK initialisiert, um die Plattformidentität des Nutzers (PGS-Spieler-ID) zu authentifizieren.
2. Nach diesem Hintergrund-Handshake werden dem Spieler Optionen zum Erstellen eines IGA angezeigt, z. B. Neues Konto erstellen, Über Google anmelden oder andere Methoden für die Anmeldung über soziale Netzwerke.
3. Sobald der Spieler ein IGA erstellt oder auswählt, wird dieses Konto im Backend des Spiels an die ausgewählte primäre Kennung gebunden.
4. Das Spiel verknüpft diese ausgewählte IGA auch mit der PGS-Spieler-ID und kennzeichnet sie als die zuletzt gespielte IGA für die nahtlose Wiederherstellung.

Spieler mit aktiven Sitzungen

In diesem Szenario starten Spieler das Spiel auf einem Gerät, auf dem sie bereits eine aktive Sitzung haben. Ziel ist es, einen nahtlosen Einstieg zu ermöglichen.

1. Wenn der Spieler die App startet, werden die Play-Spieldienste im Hintergrund authentifiziert. Sie erhalten dann die Spieler-ID, mit der Sie den Fortschritt bei Erfolgen und anderen Play-Spieldienste-Funktionen verfolgen können.
2. Gleichzeitig werden, sofern zutreffend, Anmeldebildschirme umgangen und der Spieler wird sofort in seiner aktiven IGA-Sitzung oder der letzten IGA, die mit seiner Spieler-ID verknüpft ist, angemeldet, sodass er das Spiel sofort fortsetzen kann.

Spieler wechseln das Konto

Dieser Ablauf wird ausgelöst, wenn ein Spieler mit einer aktiven Sitzung zu den Spieleinstellungen wechselt, um das Konto zu ändern. Das kann beispielsweise der Fall sein, wenn Sie sich von einem Hauptkonto abmelden, um ein alternatives Konto zu verwenden.

1. Der Spieler meldet sich von der aktuellen IGA ab, die Verbindung zur PGS-Plattform bleibt jedoch aktiv.
2. Wenn sich der Spieler mit einem anderen IGA anmeldet, wird dieses neue Konto nur für die nahtlose Wiederherstellung als zuletzt verwendetes IGA an die aktuelle PGS-Spieler-ID gebunden.

Nahtlose Wiederherstellung für zurückkehrende Spieler

Dieses Szenario tritt ein, wenn ein Spieler das Spiel nach einer Inaktivitätsphase, nach einer Neuinstallation oder auf einem völlig neuen Gerät startet. Für das Spiel wird die Implementierung der nahtlosen Wiederherstellung empfohlen.

1. Beim Start authentifiziert PGS den Nutzer und stellt dem Spiel die PGS-Spieler-ID zur Verfügung.
2. Das Spiel prüft im Backend (oder ruft das Speicherdaten-Token ab, wenn die Recall API verwendet wird), ob bereits ein zuletzt gespieltes IGA mit dieser PGS-ID verknüpft ist.
3. Wenn ein Link gefunden wird, stellt das Spiel automatisch den Fortschritt des Spielers wieder her und meldet ihn an. Der manuelle Anmeldebildschirm wird dabei übersprungen.
4. Andernfalls wird dem Spieler der Anmeldebildschirm angezeigt.
   1. Der Spieler wählt dann eine Anmeldemethode aus und meldet sich in einem IGA an.
   2. Das Spiel verknüpft diese IGA dann mit der PGS-Spieler-ID als zuletzt gespielte IGA für die nahtlose Wiederherstellung.

Gastmodus

Spieler können Ihr Spiel starten und spielen, indem sie ein lokales Gastkonto verwenden. Die Play Games-Dienste authentifizieren den Spieler weiterhin im Hintergrund. Wenn der Spieler Fortschritt speichern auswählt, wird die Gast-Sitzung in Ihrem Spiel in eine permanente IGA umgewandelt und an die Spieler-ID gebunden. Weitere Informationen zur Konfliktlösung finden Sie unter Gastkonto.