Das Google Play-Spieldienste, Games v1 SDK basiert auf Google-Anmeldung für Android, die eingestellt und 2025 aus dem Google Play-Dienste Auth SDK (com.google.android.gms:play-services-auth) entfernt wird.
Neue Spiele-Apps können bis 2025 das Games v1-SDK verwenden. Durch die Entfernung der Google-Anmeldung entstehen Abhängigkeitsprobleme für bestehende Spiele-Apps. Durch die Migration vorhandener Spiele-Apps vom Games v1-SDK zum Games v2-SDK werden Abhängigkeitsprobleme behoben, die durch die Entfernung der Google-Anmeldung entstanden sind.
In diesem Dokument wird die Interaktion zwischen der Spieleanwendung und verschiedenen SDKs beschrieben. In diesem Dokument werden auch die Funktionen der Anwendung mit denen der Play-Spieldienste-SDKs für Spiele v1 und Spiele v2 verglichen.
SDK-Interaktionen
Die Diagramme veranschaulichen die Interaktion zwischen einer Spieleanwendung auf Android, GMS Core, Play-Spieldiensten und einem Drittanbieter-Spieleserver. Darin wird beschrieben, 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-Spieldiensten 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.
- Gateway für Play-Spieldienste
- :
- Ein logisches Gateway, das die Kommunikation zwischen GMS Core und dem Play-Spieldienste-Server vermittelt.
- Verarbeitet API-Anfragen, Datenumwandlung und Authentifizierung für die Serverkommunikation.
- Server der Play-Spieldienste
- :
- Stellt die Backend-Dienste der Play-Spieldienste dar, die für das Speichern von Spieldaten, die Verwaltung von Nutzerkonten und die Bereitstellung von Mehrspielerfunktionen zuständig sind.
- Games Gateway von Drittanbietern
- :
- Wenn Ihre Spieleanwendung als Drittanbieteranwendung (3P) eingestuft wird, kommuniziert die Clientbibliothek über die Drittanbieter-Spieleserver mit den Play-Spieldienste-Servern.
- Dies bedeutet, dass sich die Anwendung auch bei einem anderen Dienstanbieter authentifizieren kann.
- Spiele-Server eines Drittanbieters
- :
- 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.
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 mit GoogleSigninClient zusätzliche
OAuth 2.0-Bereiche 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 Web-APIs von Play Spiele-Diensten angefordert wird.
Weitere Informationen finden Sie unter Serverseitiger Zugriff auf Play-Spieldienste und Serverauthentifizierungscodes 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. |
Willkommens-Pop-up |
Zusätzlicher Code erforderlich. Entwickler können die Platzierung und das Timing steuern. |
Kein zusätzlicher Code erforderlich. Einheitliche Benutzeroberfläche für alle Spiele, die mit dem Games v2-SDK konfiguriert sind. |
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 wird nicht unterstützt. |
Mehrere Play-Spieldienste-Konten und Einstellungen pro Spiel |
Die Kontoverwaltung ist in Ihrem Spiel möglich. |
Nutzer können das Play Spiele-Profil in den Einstellungen des Mobilgeräts ändern. Weitere Informationen zum Wechseln von Play Spiele-Profilen auf Mobilgeräten |