Zeitplan für die Einstellung

In diesem Dokument finden Sie den Zeitplan für die Einstellung des Play Games-Dienste v1 SDK.

Nach der Einstellung der Google Sign-in (GSI) API und der geplanten Abschaltung stellen wir das Play Games-Dienste v1 SDK und die zugehörigen APIs ein. Sie müssen Ihr Spiel zum Play Games-Dienste v2 SDK migrieren, um die neuesten Funktionen nutzen zu können.

Die Zeitpläne für die Einstellung sind wie folgt:

Datum Einstellungsmeilenstein
Auswirkungen Entwickleraktion
Mai 2026 Entfernung der GSI API Wenn einem Spiel neue Funktionen wie LiveOps, Missionen oder Karten hinzugefügt werden, die nicht auf der Google-Authentifizierung basieren (mit Ausnahme der Play Games-Dienste v1-API), funktionieren diese Funktionen weiterhin.

Wenn in Ihrem Spiel ein Drittanbieter-SDK oder ein anderes Google-SDK als Play Games-Dienste v1 verwendet wird, für das ein Authentifizierungs-Upgrade erforderlich ist, kann ein Upgrade auf die neueste Version dieses SDK zu Kompilierungsfehlern führen.
  1. Folgen Sie dem hier beschriebenen Lösungsweg, wenn ein Kompilierungsfehler auftritt.
  2. Migrieren Sie gemäß dem hier erwähnten Lösungspfad zu Version 2 der Play Games-Dienste, sobald die Lösung gegen Ende des 2. Quartals 2026 veröffentlicht wird.
15. Juni 2026 Entfernung der Play Games-Dienste v1 API Ein neues Play Games-Dienste v1 SDK ohne GSI-APIs wird veröffentlicht. Es wird keine weiteren Fehlerkorrekturen oder Updates für bestehende Play Games-Dienste v1-Funktionen geben.
Wenn ein vorhandener v1-Titel auf die neueste Version der Play Games-Dienste v1 aktualisiert wird, funktionieren die Play Games-Dienste-Funktionen in dieser neuen Version nicht mehr.
  1. Spiele, die Play Games-Dienste v1 verwenden, dürfen ihr v1‑SDK nicht auf com.google.android.gms:play-services-games:25.0.0 aktualisieren, da dadurch v1‑APIs entfernt werden.
  2. Bei Spielen, die nicht zu Version 2 der Play-Spieldienste migriert wurden, können Kompilierungsfehler auftreten, da play-services-auth ab Mai 2026 keine GSI mehr bereitstellt.
  3. Gemäß dem im vorherigen Abschnitt genannten Zeitplan können Spiele darauf achten, dass andere SDKs aktualisiert werden, und dafür sorgen, dass andere SDKs das neue Credential Manager SDK erst verwenden, wenn sie zu Play Games-Diensten v2 migriert wurden.
Mai 2027 Einstellung der Play Games-Dienste – Version 1 Der gesamte Traffic von Play Games-Diensten v1 wird blockiert, ohne dass ein Spiel kompiliert wird.

Vorhandene APIs der Play Games-Dienste v1 funktionieren in der Produktionsumgebung nicht mehr.
Die einzige Möglichkeit, Unterbrechungen beim Onboarding und bei der Anmeldung von Spielern zu vermeiden, besteht darin, vor diesem Termin zu Play Games-Dienste V2 zu migrieren.
  • Ab September 2025 werden das games v1 SDK und die zugehörigen APIs eingestellt. Bestehende Titel mit den vorherigen v1-Integrationen funktionieren weiterhin. Bei Google Play ist es nicht möglich, neue Titel zu veröffentlichen, die das v1 SDK und die v1 APIs verwenden.

  • Ab dem 15. Juni 2026 werden die eingestellten APIs aus dem SDK entfernt.

  • Ab Juni 2027 wird das games v1 SDK entfernt. Aufrufe dieser APIs schlagen fehl, auch wenn Sie frühere Versionen des SDK verwenden.

In der folgenden Tabelle sind die Versionen des Games v1-SDK, die Einstellungsdaten und die Migrationsanleitungen aufgeführt:

SDK-Version Erscheinungsdatum Migrationsanleitung
play-services-games:v24.0.0 12. September 2025
Eingestellt
Zu Version 2(Java oder Kotlin) migrieren
v0.10.15 Unity 17. September 2025
Eingestellt
Zu Version 2(Unity) migrieren
play-services-games:v25.0.0 15. Juni 2026
Die Play Games-Dienste v1 API wird aus dem SDK entfernt.
Zu Version 2(Java oder Kotlin) migrieren

Beispiel für die Auswirkungen der Entfernung der GSI API

Stellen Sie sich ein Szenario vor, in dem ein SDK, SDK1, eine Liste von Freunden aus dem Google-Konto eines Spielers abruft. Damit Spieler diese Funktion nutzen können, müssen sie ihr Google-Konto mit dem Google-Authentifizierungs-SDK authentifizieren.

In den folgenden Situationen müssen Sie das Google Authentication SDK möglicherweise aktualisieren:

  • Beheben Sie einen kritischen Fehler im Authentifizierungsablauf.
  • Implementieren Sie neue Passkey-Funktionen, die vom Credential Manager SDK angeboten werden.

In der folgenden Tabelle werden die drei Szenarien für die Aktualisierung der Authentifizierungsintegration Ihres Spiels beschrieben:

  • Szenario 1:SDK1 wird auf das neueste Google Authentication SDK aktualisiert.
  • Szenario 2:SDK1 wird in Credential Manager integriert. Das Google Authentication SDK bleibt unverändert.
  • Szenario 3:SDK1 wird in Credential Manager eingebunden und das Google Authentication SDK wird entfernt.
Funktion Szenario 1 Szenario 2 Szenario 3
Szenarien für die Authentifizierungsaktualisierung
  1. Ich wusste nicht, dass die GSI-APIs entfernt wurden. Das Spiel wurde auf das neueste Auth-SDK aktualisiert.
  2. Die vorhandene Authentifizierungsfunktion funktioniert nicht mehr und SDK1 muss das Credential Manager SDK einbinden.
  3. Das Spiel wird mit der neuesten Version des Auth SDK und des Credential Manager SDK veröffentlicht.
SDK1 ist sich der Entfernung der GSI API bewusst und führt kein Upgrade des Auth SDK durch, sondern nutzt die Google-Authentifizierungsfunktion mit dem Credential Manager SDK in der neuesten Version. In der neuesten Version wird die Google-Authentifizierungsfunktion von SDK1 mit dem Credential Manager SDK unterstützt. Das Auth SDK wird vollständig entfernt.
Play Games-Dienste v1 SDK Nicht geändert Nicht geändert Nicht geändert
Was passiert beim Kompilieren eines Spiels?
  1. Für Play Games-Dienste v1 ist eine separate Auth SDK-Integration erforderlich. Da das Auth SDK ohne GSI-APIs aktualisiert wird, funktioniert Play Games-Dienste v1 nicht mehr.
  2. Beim Kompilieren des Spiels treten Fehler auf.
  3. Das Spiel versucht dann, den Auflösungspfad zu befolgen.
Fehler bei der Kompilierung des Spiels Das Spiel versucht dann, den Auflösungspfad zu befolgen.
Mögliches Spielerlebnis – Da das Spiel nicht kompiliert werden kann, ist keine Veröffentlichung möglich.
  1. Der Spieler sieht die Kontoauswahl der Play Games-Dienste, wenn er sich mit den Play Games-Diensten v1 authentifiziert.
  2. Der Nutzer sieht das Bottom Sheet des Credential Manager, wenn er sich für die SDK1-Funktion authentifiziert.
  1. Der Spieler sieht die Kontoauswahl der Play Games-Dienste, wenn er sich mit den Play Games-Diensten v1 authentifiziert.
  2. Der Nutzer sieht das Bottom Sheet des Credential Manager, wenn er sich für die SDK1-Funktion authentifiziert.
Lösungsweg für Spieleentwickler
  1. Finden Sie heraus, welches SDK das Upgrade des Auth SDK verursacht.
  2. Machen Sie die SDK-Version von SDK1 rückgängig.
  3. Kompiliere das Spiel mit der Funktion neu.
  4. Wenn für die neue Spielfunktion ein Upgrade auf SDK1 erforderlich ist, sprechen Sie mit SDK1, um Szenario 2 oder 3 für die Version zu übernehmen.
  1. Nichts
  2. Wenn Sie jedoch auch einen Über Google anmelden-Button verwenden, müssen Sie möglicherweise zwei Arten von Google-Anmelde-Abläufen für Spieler verwenden.
  1. Nichts
  2. Wenn Sie jedoch auch einen Über Google anmelden-Button verwenden, müssen Sie möglicherweise zwei Arten von Google-Anmelde-Abläufen für Spieler verwenden.
Endgültiges Ergebnis für Play Games-Dienste v1 Das Spiel muss nicht auf Play Games-Dienste v2 aktualisiert werden, aber SDK1 ist weiterhin veraltet. Das Spiel muss nicht von Version 1 auf Version 2 der Play Games-Dienste aktualisiert werden. Das Spiel muss nicht von Version 1 auf Version 2 der Play Games-Dienste aktualisiert werden.