Google Play Games-Dienste, games v1 SDK basiert auf Google Log-in für Android, das eingestellt wird und 2025 aus dem Google Play-Dienste-Auth-SDK (com.google.android.gms:play-services-auth) entfernt wird. Neue Gaming-Apps können games v1 bis 2025 verwenden. Die Entfernung von Google Log-in führt zu Abhängigkeitsproblemen bei bestehenden Gaming-Apps. Durch die Migration bestehender Gaming-Apps vom games v1 SDK zum games v2 SDK werden Abhängigkeitsprobleme behoben, die durch die Entfernung von Google Log-in entstehen.
Die Migration von Google Play Games-Diensten V1 zu V2 ist ein wichtiges Update, das die Entwicklung vereinfacht und plattformübergreifende Spiele unterstützt. Bei den Google Play Games-Diensten v2 wird die Plattformidentität von der In-Game-Identität getrennt. Die Google Play Games-Dienste v2 fungieren 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 SDK für die Play Games-Dienste v2 wird die Spieler-ID für Plattformfunktionen wie Erfolge und Bestenlisten verwendet, ohne dass vorhandene Onboarding- oder Anmeldeabläufe geändert werden.
In diesem Dokument wird beschrieben, wie die Spieleanwendung mit verschiedenen SDKs interagiert. 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-Diensten (GMS) Core, Play Games-Diensten und einem Drittanbieter-Spieleserver. Sie zeigen, wie die Anwendung die Dienste von Google für die Authentifizierung und Spielfunktionen nutzt und gleichzeitig mit einem separaten Drittanbietersystem interagiert.
games v2 (aktuell)
games v1 (Legacy)
Im Folgenden finden Sie einen kurzen Überblick über die Komponenten und SDKs:
- Spieleanwendung
- Dies stellt die Spielanwendung des Nutzers dar, die auf einem Android-Gerät ausgeführt wird.
- Es enthält zwei primäre Komponenten:
- 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 Spielen v1 verantwortlich.
- 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 Google-eigene Ebene auf Android.
- Die Spieleanwendung verwendet zwei GMS Core-Module:
- Das Spielemodul bietet spielebezogene Funktionen wie Bestenlisten, Erfolge und die Verwaltung des Spielstatus.
- Auth-Modul: Verarbeitet Nutzerauthentifizierungs- und ‑autorisierungsvorgänge.
- Die Games- und Auth-SDKs in der Spieleanwendung kommunizieren über AIDL-Schnittstellen mit den entsprechenden Modulen, was auf eine Inter-Process Communication (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, Datenumwandlung und Authentifizierung für die Serverkommunikation.
- Server der Play Games-Dienste
- 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.
- Gateway für Spiele von Drittanbietern
- Wenn Ihre Spieleanwendung als Drittanbieteranwendung (3P) eingestuft wird, kommuniziert die Clientbibliothek über die Drittanbieter-Spieleserver 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-Spielegateway.
Gründe für die Migration Ihres Titels zu Version 2 der Play Games-Dienste
Die Umstellung von Play Games-Dienste v1 auf v2 ist eine wichtige architektonische Modernisierung, die die Entwicklung vereinfacht und plattformübergreifende Spiele unterstützt.
Im Gegensatz zu Version 1, die als primäres In-Game-Identitätssystem diente, werden in Version 2 der Play-Spieldienste 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 Back-Ends verwalten. Mit Version 2 des SDK für die Play Games-Dienste können Spiele die Spieler-ID der Play Games-Dienste verwenden, um auf Plattformfunktionen zuzugreifen, ohne dass bestehende Onboarding- oder Anmeldeabläufe geändert werden müssen. In diesem Dokument werden die Migrationsprozesse beschrieben. Dabei werden architektonische Prinzipien, Migrationspfade und Strategien für die Kommunikation mit Spielern behandelt. Die Einhaltung ist angesichts des offiziellen Zeitplans für die Einstellung entscheidend für die Kontinuität der Spieler.
Plattformauthentifizierung und In-Game-Authentifizierung vergleichen
In Version 2 der Play Games-Dienste ist das Konzept der „Anmeldung“ in zwei separate Ebenen unterteilt:
- Plattformidentität: Das SDK übernimmt die Plattformauthentifizierung.
- Identität im Spiel
Plattformauthentifizierung
Play-Spieldienste fungieren ausschließlich als Plattform-Engagement-Ebene. Es verwaltet die Beziehung des Spielers zum Google Play Games-Ökosystem (Erfolge, Bestenlisten und Events) und nicht die Authentifizierung in einem bestimmten Spielkonto oder Inventar.
- Lautlos und automatisch:Die Authentifizierung erfolgt automatisch im Hintergrund, wenn das Spiel gestartet wird. Für 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 für dasselbe Spiel auf allen Geräten gleich, sollte aber hauptsächlich zum Erfassen von Plattformstatistiken (z. B. Fortschritt bei Erfolgen) verwendet werden.
- Entkoppelt:Version 2 der Play Games-Dienste darf nicht als primäres Identitätssystem Ihres Spiels verwendet werden, um das In-Game-Konto eines Spielers mit seinem Spielfortschritt oder Inventar zu verwalten. Version 2 der Play Games-Dienste dient ausschließlich als sekundäre, dauerhafte Plattform-ID.
In-Game-Authentifizierung
Entwickler sind für die Verwaltung des In-Game-Kontos (IGA) verantwortlich. Dieses Identitätssystem verknüpft den Fortschritt, das Inventar und die Währung eines Spielers in Ihrem Spiel.
- Primäre Identität:Sie können Ihr eigenes Backend, „Über Google anmelden“ (Sign in with Google, 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. z. B. 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 in Ihrem Spiel, mit denen Spieler zwischen ihren In-Game-Konten wechseln, nichts ändert. Während die Spieler dies tun, bleiben sie weiterhin über die Play Games-Dienste auf der Play Games-Plattform authentifiziert und Sie senden weiterhin ihre Daten zu Erfolgen und anderen Play Games-Dienste-Funktionen anhand der persistenten Spieler-ID.
Migrationsanforderung: In-Game-Konten mit Google OpenID anstelle der Play Games-Dienste-Spieler-ID verknüpfen
In den Play Games-Diensten v1 haben Entwickler die Play Games-Dienste als primären Identitätsanbieter verwendet. Über einen „Google Play“-Button würde das In-Game-Konto eines Spielers direkt mit seinem Player ID verknüpft.
Mit den Play Games-Diensten v2 wird dies geändert, da beim Start eine automatische, stille Plattformauthentifizierung erfolgt. Das resultierende Player ID wird jetzt ausschließlich für Plattformfunktionen wie Bestenlisten und Erfolge verwendet und ist vom Hauptkonto-Login getrennt.
Spiele müssen die primäre Identität jetzt unabhängig über einen speziellen Anmeldebildschirm verwalten, der Methoden wie „Über Google anmelden“ (SiWG) oder andere Konten bei sozialen Netzwerken anbietet. Wichtig ist, dass Play Games-Dienste v2 nicht als primäres Identitätssystem verwendet werden dürfen.
Diese Änderung der Architektur erfordert eine entsprechende Änderung der Struktur der Kontodaten von Entwicklern. Das In-Game-Konto (IGA) muss von der primären Bindung an Player ID entkoppelt werden.
Stattdessen muss die IGA jetzt an eine stabile, primäre Kennung gebunden werden, die unabhängig von den Play Games-Diensten ist. Die empfohlene ID ist die Open ID, die vom „Über Google anmelden“-Vorgang (SiWG) bereitgestellt wird. Diese Open ID dient als eindeutiger, dauerhafter Schlüssel für das primäre Konto des Spielers in Ihrem System.
Die IGA kann jedoch weiterhin als sekundäre Bindung mit dem Player ID verknüpft werden. Diese sekundäre Verknüpfung erfüllt zwei wichtige Funktionen:
- So kann das Spiel weiterhin den Fortschritt für Play Games-Funktionen (Erfolge usw.) verfolgen und aktualisieren, die mit diesem bestimmten Spieler verknüpft sind.
- Dadurch wird die Funktion „Nahtlose Wiederherstellung“ aktiviert, mit der sich ein Spieler auf einem neuen Gerät oder nach einer Neuinstallation automatisch in der zuletzt verwendeten IGA anmelden kann.
Wenn Sie dieses entkoppelte Identitätsmodell verstehen, können Sie den richtigen technischen Migrationspfad für Ihr Spiel finden.
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; keine play-services-auth erforderlich. |
Autorisierung |
Zusätzlicher Code für Erfolg, Fehler und Wiederholungen. |
Vom SDK verwaltet |
Serverzugriffstoken |
Kann zusätzliche OAuth 2.0-Bereiche mit GoogleSigninClient anfordern.Zusätzlicher Code für die Fehlerbehandlung während der Authentifizierung. |
Kann drei grundlegende OAuth 2.0-Identitätsbereiche mit GamesSignInClient anfordern, wenn serverseitiger Zugriff auf die Play Games-Dienste-Web-APIs angefordert wird.Weitere Informationen finden Sie unter Serverseitiger Zugriff auf Play Games-Dienste und Server-Authentifizierungscodes abrufen. |
Anmeldevorgang |
Verwendet GoogleSigninClient.Zusätzlicher Code für die Verarbeitung von Boilerplate-Code für die automatische Authentifizierung und Fehlerbehandlung. |
Verwendet GamesSignInClient.Das SDK übernimmt Boilerplate-Code, automatische Authentifizierung und Fehlerbehandlung. Die Anmeldung ist in zwei separate Ebenen unterteilt:
|
Begrüßungs-Pop-up |
Zusätzlicher Code erforderlich. Entwickler können die Platzierung und den Zeitpunkt der Anzeige steuern. |
Kein zusätzlicher Code erforderlich. Einheitliche Benutzeroberfläche für alle Spiele, die mit dem Games SDK V2 konfiguriert wurden. |
Abhängigkeiten |
Erfordert play-services-auth. |
Das Games-Modul übernimmt die Autorisierung und Authentifizierung. Sie müssen keine zusätzlichen Abhängigkeiten hinzufügen. |
| Abmelden |
Verwendet GoogleSignInClient.signOut. |
Die Sign-out API ist nicht erforderlich, da die Play Games-Dienste v2 eine dauerhafte Plattformidentität sind. |
Mehrere Play Games-Dienste-Konten und Einstellungen pro Spiel |
Die Kontoverwaltung ist in Ihrem Spiel möglich. |
Nutzer können das Play Games-Dienste-Profil in den Geräteeinstellungen des Mobilgeräts ändern. Weitere Informationen finden Sie unter Play Games-Profile auf Mobilgeräten wechseln. |