Plattformauthentifizierung

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

Da das Play Games Services 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 die Richtlinien für die Nutzerfreundlichkeit von Google Play Games Level Up erfüllt.

Konzepte der Authentifizierung

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

Plattformauthentifizierung

Die Play-Spieldienste 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-Spieldienste ist keine manuelle Schaltfläche Anmelden erforderlich.
• Spieler-ID:Nach erfolgreicher Plattformauthentifizierung stellen die Play-Spieldienste 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 verfolgen.
• Entkoppelt:Sie dürfen Play-Spieldienste nicht als primäres Identitätssystem Ihres Spiels verwenden, um das In-Game-Konto (IGA) des Spielers, den Spielfortschritt oder das Inventar zu verwalten. Die 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-Spieldienste 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-Spieldiensten zuzugreifen.

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

In-Game-Authentifizierung

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

• Primäre Identität:Sie können Ihr eigenes Backend, „Mit Google anmelden“ (SiWG) oder andere Anbieter als primäre Anmeldemethode verwenden.
• Unabhängigkeit:Spieler können sich in den Play-Spieldiensten (Plattformidentität) anmelden, um Erfolge zu erzielen, während sie in einer beliebigen IGA angemeldet sind, z. B. in einem Gastkonto oder einem bestimmten SiWG-Konto.
• Verwaltung mehrerer IGAs:Die Play-Spieldienste übernehmen nur die Plattformauthentifizierung. Ihr Spiel verwaltet die primäre Authentifizierung von Spielern in ihren IGAs. Das bedeutet, dass sich die bestehenden Abläufe für Spieler, mit denen sie zwischen ihren IGAs wechseln können, nicht ändern. Wenn Spieler das Konto wechseln, bleiben sie über die Play-Spieldienste bei der Play Games-Plattform authentifiziert. Sie senden weiterhin ihre Daten zu Erfolgen und anderen Play-Spieldienste-Funktionen 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 Folgendes:

• Schaltfläche „Über Google anmelden“:In PGS v1 wurde mit der Schaltfläche Google Play häufig 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 sich Spieler authentifizieren und auf ihr IGA zugreifen können.
• Google-Anmelde-SDKs:
  • Verwenden Sie für Android und iOS die Standard-Google-Anmelde-SDKs, 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-Spieldienste, um den Fortschritt eines Spielers bei Play Games-Funktionen wie Erfolgen zu melden.

Empfohlene Integration

So integrieren Sie Ihr Spiel in die Play-Spieldienste:

Initialisierung und Authentifizierung

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

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

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

Profilerstellung

Spieler benötigen ein Play-Spieldienste-Profil, um die Plattform nutzen zu können. Einige Spieler haben beim Starten Ihres Spiels möglicherweise kein Play-Spieldienste-Profil. Diese Spieler werden aufgefordert, einen zu erstellen.

Aufforderungen zur automatisch ausgelösten Profilerstellung werden standardmäßig automatisch angezeigt, wenn Sie ein Spiel ohne Play Games-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 vorhandenen IGA anzumelden.

OAuth-Bereiche

Die Play-Spieldienste nutzen das OAuth-System, damit Spieler Ihrem Spiel Zugriff auf ihr Konto gewähren können. Die Play-Spieldienste haben einen eindeutigen Bereich für Spiele (games-lite) und verwenden einen anderen Bereich (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 ersten 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, Mit 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, wird der PGS im Hintergrund authentifiziert. Sie erhalten die Spieler-ID, um den Fortschritt bei Erfolgen und anderen Play-Spieldienste-Funktionen zu verfolgen.
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, die das Konto wechseln

Dieser Ablauf wird ausgelöst, wenn ein Spieler mit einer aktiven Sitzung zu den Spieleinstellungen wechselt, um das Konto zu ändern. Das kann z. B. 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 gespieltes 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 ein zuletzt gespieltes IGA bereits 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, um eine nahtlose Wiederherstellung zu ermöglichen.

Gastmodus

Spieler können das Spiel starten und mit einem lokalen Gastkonto spielen. PGS authentifiziert weiterhin im Hintergrund. Wenn der Spieler Fortschritt speichern auswählt, wird die Gast-Sitzung in ein permanentes IGA umgewandelt und an die PGS-Spieler-ID gebunden.