Das Google Play Games-Dienste, Spiele v1 SDK basiert auf Google Log-in für Android, das eingestellt und 2025 aus dem Google Play Services Auth SDK (com.google.android.gms:play-services-auth) entfernt wird.
Neue Spiele-Apps können bis 2025 das Games v1-SDK verwenden. Die Entfernung des Google Log-ins führt zu Abhängigkeitsproblemen 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 von Google Log-in entstanden sind.
In diesem Dokument wird beschrieben, wie die Spieleanwendung mit verschiedenen SDKs interagiert. In diesem Dokument werden auch die Funktionen der Anwendung mit denen der Play Games-Dienste Games v1- und Games v2-SDKs verglichen.
SDK-Interaktionen
Die Diagramme veranschaulichen die Interaktion zwischen einer Spieleanwendung auf Android, GMS Core, Play Games-Diensten 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 Play Games-Diensten zuständig ist.
- Auth SDK: Das Google Play-Dienste Auth SDK ist für die Verarbeitung von Nutzerauthentifizierungs- und Autorisierungsvorgängen 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 wird auch als Google Play-Dienste bezeichnet.
- 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.
- Drittanbieter-Spielegateway
- :
- 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.
- 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 Play Games-Dienste-Web-APIs angefordert wird.
Weitere Informationen finden Sie unter Serverseitiger Zugriff auf Play Games-Dienste 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. |
Begrüßungs-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 Abmelde-API wird nicht unterstützt. |
Mehrere Play Games-Dienste-Konten und spielbezogene 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. |