Migration – Übersicht

Das games v1 SDK der Google Play Games-Dienste basiert auf Google Log-in für Android, das eingestellt wurde und aus dem Google Play-Dienste-Auth SDK (com.google.android.gms:play-services-auth) entfernt wird. Neue Spiele-Apps können das games v1 SDK bis 2025 verwenden. Durch die Entfernung von Google Log-in entstehen Abhängigkeitsprobleme für bestehende Spiele-Apps. Wenn Sie bestehende Spiele-Apps vom games v1 SDK zum games v2 SDK migrieren, werden die durch die Entfernung von Google Log-in entstandenen Abhängigkeitsprobleme behoben.

Die Migration von Google Play Games-Dienste v1 zu v2 ist ein wichtiges Update, das die Entwicklung vereinfacht und plattformübergreifendes Gaming unterstützt. Bei Google Play Games-Dienste v2 werden Plattform- und In-Game-Identität entkoppelt. Es fungiert als Identitätssystem auf Plattformebene, das Spieler beim Start automatisch authentifiziert. Die Plattformidentität ist jetzt vom primären In-Game-Kontosystem getrennt, das Sie unabhängig mit Tools wie „Über Google anmelden“ oder proprietären Backends verwalten müssen. Bei der Integration des Play Games-Dienste v2 SDK wird die Spieler-ID für Plattformfunktionen wie Erfolge und Bestenlisten verwendet, ohne dass bestehende Onboarding- oder Anmeldeabläufe geändert werden.

In diesem Dokument wird die Interaktion zwischen der Spieleanwendung und verschiedenen SDKs erläutert. Aufgrund des offiziellen Zeitplans für die Einstellung müssen Sie die Architekturprinzipien, Migrationspfade und Strategien für die Spielerkommunikation in diesem Migrationsleitfaden befolgen, um die Kontinuität für die Spieler zu gewährleisten.

SDK-Interaktionen

Die Diagramme veranschaulichen die Interaktion zwischen einer Spieleanwendung auf Android, Google Mobile-Dienste (GMS) Core, Play Games-Dienste und einem Drittanbieter-Gameserver. Sie zeigen, wie die Anwendung die Dienste von Google für die Authentifizierung und Spielfunktionen verwendet und gleichzeitig mit einem separaten Drittanbietersystem interagiert.

Im Folgenden finden Sie eine kurze Übersicht über die Komponenten und SDKs:

• Spieleanwendung
  • Dies ist die Spieleanwendung des Nutzers, die auf einem Android-Gerät ausgeführt wird.
  • Sie enthält zwei Hauptkomponenten:
    • games v1 oder games v2 SDK Das clientseitige SDK, das für die Interaktion mit den Play Games-Diensten zuständig ist.
    • Auth SDK Das Google Play-Dienste-Auth SDK ist für die Verarbeitung von Nutzerauthentifizierungs- und Autorisierungsabläufen in games v1 zuständig.
  • Beide SDKs kommunizieren über AIDL (Android Interface Definition Language), was auf ein Kommunikationsmuster zwischen verschiedenen Prozessen oder Diensten hinweist.
• GMS Core, auch Google Play-Dienste genannt
  • Dies ist die proprietäre Google-Ebene auf Android.
  • Die Spieleanwendung verwendet zwei GMS Core-Module:
    • Spielemodul : Bietet spielebezogene Funktionen wie Bestenlisten, Erfolge und die Verwaltung des Spielstatus.
    • Auth-Modul Verarbeitet Nutzerauthentifizierungs- und Autorisierungsvorgänge.
  • Die Spiele- und Auth-SDKs in der Spieleanwendung kommunizieren mit den entsprechenden Modulen über AIDL Schnittstellen, was auf die Interprozesskommunikation (IPC) hinweist.

• Play Games-Dienste-Gateway
  • Ein logisches Gateway, das die Kommunikation zwischen GMS Core und dem Play Games-Dienste-Server vermittelt.
  • Verarbeitet API-Anfragen, Datentransformationen und die Authentifizierung für die Serverkommunikation.
• Play Games-Dienste-Server
  • Stellt die Backend-Dienste der Play Games-Dienste dar, die für das Speichern von Spieldaten, die Verwaltung von Nutzerkonten und die Bereitstellung von Mehrspielerfunktionen zuständig sind.
• Drittanbieter-Gameserver-Gateway
  • Wenn Ihre Spieleanwendung als Drittanbieteranwendung gilt, kommuniziert die Clientbibliothek über die Drittanbieter-Gameserver mit den Play Games-Dienste-Servern.
  • Dies bedeutet, dass sich die Anwendung auch bei einem anderen Dienstanbieter authentifizieren kann.
• Drittanbieter-Gameserver
  • Stellt einen optionalen externen Server dar, mit dem die Spieleanwendung interagieren kann, wahrscheinlich für benutzerdefinierte Funktionen oder die Datenverwaltung.
  • Die Kommunikation mit der Anwendung erfolgt über das Drittanbieter-Gameserver-Gateway.

Warum sollten Sie Ihren Titel zu den Play Games-Diensten v2 migrieren?

Der Übergang von den Play Games-Diensten v1 zu v2 ist eine wichtige architektonische Modernisierung, die die Entwicklung vereinfacht und plattformübergreifendes Gaming unterstützt.

Im Gegensatz zu v1, das als primäres In-Game-Identitätssystem diente, werden bei den Play-Spieldiensten v2 Plattform- und In-Game-Identität entkoppelt. Es fungiert als Identitätssystem auf Plattformebene , das Spieler beim Start automatisch authentifiziert, um Funktionen wie Erfolge und Bestenlisten zu verwalten.

Sie müssen das primäre In-Game-Kontosystem Ihres Spiels jetzt unabhängig mit Tools wie „Über Google anmelden“ oder proprietären Backends verwalten. Mit dem Play Games-Dienste v2 SDK können Spiele die Play Games-Dienste-Spieler-ID verwenden, um auf Plattformfunktionen zuzugreifen, ohne dass bestehende Onboarding- oder Anmeldeabläufe geändert werden. In diesem Dokument werden Sie durch die Migration geführt und es werden Architekturprinzipien, Migrationspfade und Strategien für die Spielerkommunikation behandelt. Die Einhaltung ist angesichts des offiziellen Zeitplans für die Einstellung entscheidend für die Kontinuität für die Spieler.

Plattformauthentifizierung und In-Game-Authentifizierung vergleichen

In den Play Games-Diensten v2 ist das Konzept der „Anmeldung“ in zwei separate Ebenen unterteilt:

• Plattformidentität Das SDK verarbeitet die Plattformauthentifizierung.
• In-Game-Identität

Plattformauthentifizierung

Die Play Games-Dienste fungieren ausschließlich als Plattform-Engagement-Ebene. Sie verwalten die Beziehung des Spielers zum Google Play Games-Ökosystem (Erfolge, Bestenlisten und Ereignisse) und nicht die Authentifizierung bei einem bestimmten Spielkonto oder Inventar.

• Im Hintergrund und automatisch:Die Authentifizierung erfolgt automatisch im Hintergrund, wenn das Spiel gestartet wird. Für die Play Games-Dienste selbst 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 auf allen Geräten für dasselbe Spiel gleich, sollte aber hauptsächlich verwendet werden, um Plattformstatistiken zu erfassen (z. B. den Fortschritt bei Erfolgen).
• Entkoppelt:Die Play Games-Dienste v2 dürfen nicht als primäres Identitätssystem Ihres Spiels verwendet werden, um das In-Game-Konto des Spielers mit seinem Spielfortschritt oder Inventar zu verwalten. Die Play Games-Dienste v2 fungieren ausschließlich als sekundäre, dauerhafte Plattform-ID.

In-Game-Authentifizierung

Entwickler sind für die Verwaltung des In-Game-Kontos (In-Game Account, IGA) verantwortlich. Dies ist das Identitätssystem, das den Fortschritt, das Inventar und die Währung eines Spielers in Ihrem Spiel verknüpft.

• Primäre Identität:Sie können Ihr eigenes Backend, Über Google anmelden (SiWG) oder andere Anbieter als primäre Anmeldemethode verwenden.
• Unabhängigkeit:Ein Spieler kann in den Play Games-Diensten (Plattformidentität) angemeldet sein, um Erfolge zu erzielen, während er in einem beliebigen In-Game-Konto angemeldet ist. Beispielsweise ein Gastkonto oder ein bestimmtes SiWG-Konto.
• Verwaltung mehrerer In-Game-Konten:Die Play Games-Dienste sind nur für die Plattformauthentifizierung zuständig. Die primäre Authentifizierung von Spielern in ihren In-Game-Konten (IGAs) wird von Ihrem Spiel verwaltet. Das bedeutet, dass sich an den bestehenden Abläufen Ihres Spiels, wie Spieler zwischen ihren In-Game-Konten wechseln, nichts ändert. Während die Spieler dies tun, bleiben sie weiterhin über die Play Games-Dienste bei der Play Games-Plattform authentifiziert und Sie senden weiterhin ihre Daten zu Erfolgen und anderen Play Games-Dienste-Funktionen anhand der dauerhaften Spieler-ID.

Migrationsanforderung: In-Game-Konten mit Google Open ID anstelle der Play Games-Dienste-Spieler-ID verknüpfen

In den Play Games-Diensten v1 verwendeten Entwickler die Play Games-Dienste als primären Identitätsanbieter. Über eine Schaltfläche „Google Play“ wurde das In-Game-Konto (IGA) eines Spielers direkt mit seiner Player ID verknüpft.

Bei den Play Games-Diensten v2 wird dies durch die automatische, im Hintergrund ausgeführte Plattformauthentifizierung beim Start geändert. Die resultierende Player ID wird jetzt ausschließlich für Plattformfunktionen wie Bestenlisten und Erfolge verwendet, getrennt von der Hauptkontoanmeldung.

Spiele müssen die primäre Identität jetzt unabhängig über einen separaten Anmeldebildschirm verwalten, der Methoden wie „Über Google anmelden“ (Sign in with Google, SiWG) oder Konten bei anderen sozialen Netzwerken bietet. Wichtig: Die Play Games-Dienste v2 dürfen nicht als primäres Identitätssystem verwendet werden.

Diese architektonische Änderung erfordert eine entsprechende Änderung der Struktur der Kontodaten durch die Entwickler. Das In-Game-Konto (IGA) muss von der primären Verknüpfung mit der Player ID entkoppelt werden.

Stattdessen muss das IGA jetzt an eine stabile, primäre ID gebunden werden, die unabhängig von den Play Games-Diensten ist. Die empfohlene ID ist die Open ID , die über den Ablauf „Über Google anmelden“ (Sign in with Google, SiWG) bereitgestellt wird. Diese Open ID dient als eindeutiger, dauerhafter Schlüssel für das primäre Konto des Spielers in Ihrem System.

Das IGA kann aber weiterhin als sekundäre Verknüpfung mit der Player ID verknüpft werden. Diese sekundäre Verknüpfung erfüllt zwei wichtige Funktionen:

1. Das Spiel kann den Fortschritt für Play Games-Funktionen (Erfolge usw.), die mit diesem bestimmten Spieler verknüpft sind, weiterhin erfassen und aktualisieren.
2. Sie ermöglicht die Funktion „Nahtlose Wiederherstellung“, mit der sich ein Spieler nur auf einem neuen Gerät oder nach einer Neuinstallation automatisch in seinem zuletzt verwendeten IGA anmelden kann.

Das Verständnis dieses entkoppelten Identitätsmodells ist der Schlüssel zum richtigen technischen Migrationspfad für Ihr Spiel.

Funktionsvergleich

In dieser Tabelle finden Sie einen Funktionsvergleich zwischen dem games v1 und dem games v2 SDK:

Funktion	games v1 SDK	games v2 SDK
Authentifizierung	Integration mit play-services-auth erforderlich.	Vereinfacht und optimiert; play-services-auth nicht erforderlich.
Autorisierung	Zusätzlicher Code für Erfolge, Fehler und Wiederholungen.	Wird vom SDK verwaltet
Serverzugriffstoken	Mit GoogleSigninClient können zusätzliche OAuth 2.0-Bereiche angefordert werden. Zusätzlicher Code für die Fehlerbehandlung während der Authentifizierung.	Mit GamesSignInClient können drei grundlegende OAuth 2.0-Identitätsbereiche angefordert werden, wenn serverseitiger Zugriff auf die Web APIs der Play Games-Dienste angefordert wird. Weitere Informationen finden Sie unter Serverseitiger Zugriff auf die Play Games-Dienste und Serverauthentifizierungscodes abrufen.
Anmeldung	Verwendet GoogleSigninClient. Zusätzlicher Code für die Verarbeitung von Boilerplate-Code für die automatische Authentifizierung und Fehlerbehandlung.	Verwendet GamesSignInClient. Das SDK verarbeitet Boilerplate-Code, automatische Authentifizierung und Fehlerbehandlung. Die „Anmeldung“ ist in zwei separate Ebenen unterteilt: Plattformauthentifizierung: wird vom Play Games-Dienste v2 SDK verarbeitet. In-Game-Authentifizierung: wird vom Spiel verarbeitet.
Willkommens-Pop-up	Zusätzlicher Code erforderlich. Entwickler können Platzierung und Zeitpunkt steuern.	Kein zusätzlicher Code erforderlich. Einheitliche Benutzeroberfläche für alle Spiele, die mit dem games v2 SDK konfiguriert wurden.
Abhängigkeiten	Erfordert play-services-auth.	Das Spielemodul kümmert sich um Autorisierung und Authentifizierung. Sie müssen keine zusätzlichen Abhängigkeiten hinzufügen.
Abmeldung	Verwendet GoogleSignInClient.signOut.	Die Abmelde-API ist nicht erforderlich, da die Play Games-Dienste v2 eine dauerhafte Plattformidentität sind.
Mehrere Play Games-Dienste-Konten und spielebezogene Einstellungen	Die Kontoverwaltung ist in Ihrem Spiel möglich.	Nutzer können das Play Games-Dienste-Profil in den Einstellungen des Mobilgeräts ändern. Weitere Informationen finden Sie unter Play Games-Profile auf Mobilgeräten wechseln.