Übersicht über die Migration

Das SDK für die Google Play-Spieldienste, Spiele v1, basiert auf Google-Anmeldung 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 Games V1 verwenden. Durch die Entfernung von Google-Anmeldung entstehen Abhängigkeitsprobleme für bestehende Spiele-Apps. Durch die Migration vorhandener Spiele-Apps vom Games SDK V1 zum Games SDK V2 werden Abhängigkeitsprobleme behoben, die durch die Entfernung von Google-Anmeldung 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 Services SDKs für Spiele V1 und 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.

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 SDK V1 oder Games SDK V2 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 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-Spieldienste-Gateway
  :
  • 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 Featurevergleich zwischen den Games SDKs V1 und V2:

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 bei der Anmeldung.	Kann drei grundlegende OAuth 2.0-Identitätsbereiche mit GamesSignInClient anfordern, wenn serverseitiger Zugriff auf die Play-Spieldienste-Web-APIs 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 Anmeldung und Fehlerbehandlung.	Verwendet GamesSignInClient. Das SDK übernimmt Boilerplate-Code, die automatische Anmeldung und die Fehlerbehandlung.
Willkommens-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 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-Spieldienste-Konten und spielbezogene Einstellungen	Die Kontoverwaltung ist in Ihrem Spiel möglich.	Nutzer können das Play-Spieldienste-Profil in den Einstellungen des Mobilgeräts ändern. Weitere Informationen finden Sie unter Play Spiele-Profile auf Mobilgeräten wechseln.