Start-Checkliste

Anhand dieser Checkliste kannst du prüfen, ob dein Spiel alle Anforderungen und Best Practices erfüllt, bevor du es zur Überprüfung in Google Play Games auf dem PC einreichst.

Projekt einrichten und konfigurieren

  • SDK herunterladen und importieren: Integrieren Sie das neueste Play Spiele für PC SDK für Ihre Umgebung. Weitere Informationen finden Sie im Unity-Leitfaden oder im C++-Leitfaden.
  • Anwendungsmanifest erstellen: Erstellen Sie eine manifest.xml-Datei, in der die <PackageName> dem von Ihnen beanspruchten Play Console-Paket zugeordnet wird. Weitere Informationen finden Sie im Manifest-Leitfaden.
  • Ausführbare Datei digital signieren: Signiere dein Spiel mit einer digitalen Authenticode-Signatur und bewahre das Zertifikat für alle zukünftigen Updates auf. Sie können diesen Schritt während der lokalen Entwicklung überspringen, indem Sie den Entwicklermodus aktivieren. Sie müssen Ihre endgültige Binärdatei jedoch mit einem tatsächlichen Produktionszertifikat einer bekannten Zertifizierungsstelle signieren. Weitere Informationen finden Sie unter Spiel digital signieren.
  • Zertifikat formatieren und senden: Senden Sie die Zertifikatsinformationen an Ihren Google-Ansprechpartner. Die Zertifikatsdatei sollte nur zertifikatsbezogene Informationen enthalten. Prüfen Sie, ob alle nicht zertifikatsbezogenen Blöcke entfernt wurden. Sie können OpenSSL verwenden, um DER-/CER-Dateien in das erforderliche PEM-Format zu konvertieren.

APIs und Funktionen einbinden

  • SDK initialisieren: Implementieren Sie die SDK-Initialisierungslogik, z. B. InitializeAsync, beim Start, bevor Sie andere Funktionen verwenden. Weitere Informationen finden Sie im Initialisierungsleitfaden.
  • Nahtlose Anmeldung implementieren: Authentifiziere Spieler automatisch über das Play-Spieldienste-Konto mithilfe der Recall API. Weitere Informationen finden Sie im Leitfaden zur nahtlosen Anmeldung.
  • Play Integrity einbinden: Verwenden Sie die IntegrityClient, um Tokens anzufordern und die Legitimität von Spielsitzungen in Ihrem Backend zu überprüfen. Weitere Informationen finden Sie im Play Integrity-Leitfaden.
  • Play Install Referrer hinzufügen: Integrieren Sie die Install Referrer API, wenn Sie Quellen zur Nutzergewinnung für den PC erfassen möchten. Weitere Informationen finden Sie im Leitfaden zu Install Referrer.
  • Initialisierungsfehler beheben: Wenn Sie das SDK verwenden möchten, rufen Sie GooglePlayInitialize (C++) oder GooglePlayInitialization.InitializeAsync (C#) auf, um die API zu initialisieren. Sie müssen diese Methode aufrufen und prüfen, ob der Fortsetzungs-Callback mit InitializeResult::ok() (C++) oder Result.IsOk (C#) abgeschlossen wird und true zurückgibt, bevor Sie eine andere API verwenden können.
  • Obligatorisches Herunterfahren verarbeiten: Verarbeiten Sie kActionRequiredShutdownClientProcess, indem Sie den Clientprozess so schnell wie möglich beenden.
  • Installationsanforderungen für Google Play Games verarbeiten: Verarbeite kSdkRuntimeUnavailable, indem du Nutzer darüber informierst, dass Google Play Games und die SDK-Laufzeit installiert sein müssen, um fortzufahren.
  • Google Play Games-Updates verarbeiten: Verarbeite kSdkRuntimeUpdateRequired, indem du Nutzer darüber informierst, dass ein Update der Google Play Games Runtime erforderlich ist.

Google Play Billing implementieren

  • Kaufarten prüfen: Bestätige, dass dein Spiel nur In-App-Käufe verwendet, da wiederkehrende Zahlungen und Abos nicht unterstützt werden. Weitere Informationen finden Sie in den FAQs zur Abrechnung.
  • Produktdetails abfragen: Verwenden Sie QueryProductDetails, um lokalisierte Store-Daten abzurufen. Wenn Sie mehr als 50 Produkte haben, teilen Sie die Anfrage in mehrere Aufrufe auf. Weitere Informationen finden Sie im Leitfaden zu Abfrageprodukten.
  • Kaufvorgang starten: Verwende LaunchPurchaseFlow, um Transaktionen nativ zu verarbeiten. Wenn Sie den Browser für die Zahlung schließen, ohne zu bezahlen, tritt ein fünfminütiger Zeitüberschreitungsfehler auf. Weitere Informationen finden Sie im Leitfaden zum Kaufvorgang.
  • Bestehende Käufe wiederherstellen: Rufe QueryPurchases beim Start und beim Wechsel in den Vordergrund auf, um nicht bestätigte geräteübergreifende Käufe zu erfassen. Weitere Informationen finden Sie im Leitfaden zum Wiederherstellen von Käufen.
  • Sichere Backend-Verarbeitung: Validiert das purchaseToken im Backend, bevor ihr Berechtigungen gewährt und den Vorgang mit AcknowledgePurchase oder ConsumePurchase abschließt. Weitere Informationen finden Sie im Leitfaden zur sicheren Verarbeitung.
  • Verzögerung bei der Weitergabe von Lizenzschlüsseln berücksichtigen: Wenn du neue Abrechnungs- oder Lizenzschlüssel in der Play Console konfigurierst, solltest du mehrere Stunden einplanen, damit der Backend-Cache in allen Commerce-Bereitstellungsumgebungen synchronisiert werden kann, bevor du Live-Kauftests durchführst. Bei Kaufversuchen vor Abschluss der Synchronisierung wird der Fehlercode 6 zurückgegeben.

Im Entwicklermodus testen und QA vor der Veröffentlichung durchführen

  • Im Entwicklermodus testen: Fügen Sie <IsDeveloperMode>true</IsDeveloperMode> zu Ihrem Manifest hinzu und konfigurieren Sie die GUID für den Vorabzugriff für lokale Tests in der integrierten Entwicklungsumgebung (IDE). Wenn du keine GUID für Early-Access-Partner hast, fülle das Antragsformular aus.
  • Käufe im Entwicklermodus verwalten: Wenn du Käufe im Entwicklermodus testest, musst du den Kauf innerhalb von drei Minuten verbrauchen, um automatische Erstattungen zu verhindern. Weitere Informationen finden Sie in den FAQs zu Tests.
  • Entwicklermodus entfernen: Sie müssen das Tag <IsDeveloperMode> so schnell wie möglich entfernen, bevor Sie Ihren Release-Build verpacken. Weitere Informationen finden Sie im Leitfaden zum Entwicklermodus.
  • Argumente mit Launchern von Drittanbietern weiterleiten: Alle unbekannten Befehlszeilenargumente, die der Launcher vom Google Play Games-Client empfängt, werden direkt an den erstellten Spielprozess weitergeleitet. Weitere Informationen finden Sie im Leitfaden für mehrere Prozesse.
  • Mit einem VPN testen: Wenn Sie von einer nicht unterstützten Region aus testen, verwenden Sie ein VPN mit aktiviertem TUN-Modus, um eine unterstützte IP-Adresse zu erhalten. Weitere Informationen finden Sie in den FAQ zu VPN-Tests.
  • Unterstützung von Desktop-Verknüpfungen: Informationen zur nahtlosen Unterstützung von Desktop-Verknüpfungen finden Sie in den FAQs zu Verknüpfungen. Wenn Sie das Spiel oder einen Launcher eines Drittanbieters direkt über eine Verknüpfung starten, kann dies zu Initialisierungsfehlern führen.

Spiel verpacken, testen und veröffentlichen

  • WAB packen: Verwende das Play Publishing Tool, um dein Spiel in ein Windows App Bundle (WAB) zu packen. Die WAB-Datei muss kleiner als 10 GB sein, wenn sie über den Installer veröffentlicht wird, und kleiner als 200 GB, wenn sie über die verwaltete Veröffentlichung von Google Play veröffentlicht wird. Weitere Informationen finden Sie im Leitfaden zum Verpacken.
  • Aktuelle SDKs und Tools verwenden: Kompiliere und verpacke deinen Release mit den aktuellen Versionen des Play Spiele auf dem PC SDK, des Play Spiele auf dem PC Unity SDK, des Play PC-Entwicklertools und des Play-Publishing-Tools.
  • Prüfen, ob erhöhte Rechte erforderlich sind: Wenn das Installationsprogramm, der Launcher oder das Deinstallationsprogramm bei jedem Start als Administrator ausgeführt werden muss, prüfen Sie, ob Sie INSTALLER_REQUIRES_ELEVATION, LAUNCHER_REQUIRES_ELEVATION oder UNINSTALLER_REQUIRES_ELEVATION auf true festgelegt haben. Andernfalls werden sie nicht mit Administratorberechtigungen ausgeführt, was zu einem Startfehler führt. Weitere Informationen finden Sie unter WAB-Konfigurationsdateiformat.
  • Installationsprogramme für Drittanbieter-Launcher einreichen: Wenn Sie einen Drittanbieter-Launcher verwenden, reichen Sie das Installationsprogramm im WAB ein. Weitere Informationen finden Sie im Leitfaden zum Veröffentlichen von Installationsprogrammen.
  • Auto-Play-Sitzungstoken verarbeiten: Wenn Sie Auto-Play aktivieren, indem Sie acceptsCommandLineArguments="true" in play_publishing_config.xml festlegen, prüfen Sie, ob Ihr Installationsprogramm das Befehlszeilenargument --g_session_token=<token> extrahiert und zum Starten des Spiels verwendet. Achten Sie darauf, dass Ihr Installationsprogramm den Fallback-Fall verarbeitet, wenn das Token nicht vorhanden ist. Weitere Informationen finden Sie in den FAQs zum Launcher.
  • Spiel und Launcher oder Installationsprogramm aktualisieren: Deine Paketinhalte, einschließlich Launcher-Installationsprogrammen, müssen sich selbst aktualisieren können. Alle Ressourcen verwalten, die Ihr Spiel benötigt, einschließlich der Aktualisierung des Launchers selbst.
  • Informationen zur Veröffentlichung mit Google teilen: Wende dich an deinen Play-Partner und teile ihm den Paketnamen, die Länder, in denen die Veröffentlichung erfolgen soll (mit zweistelligen ISO-Codes, z. B. DE, AT, CH), sowie das Datum und die Uhrzeit der Veröffentlichung in koordinierter Weltzeit (UTC) mit.
  • Testzugriff einrichten: Geben Sie eine externe Google-Gruppe an, die für Tests, Dokumentation und Google Drive-Zugriff auf eine Zulassungsliste gesetzt werden soll. Teile eine E‑Mail-Liste mit Testkonten mit deinem Play-Partner, da Play Console-Test-Tracks für PC nicht unterstützt werden.
  • PC-Formfaktor hinzufügen: Füge deiner App in der Google Play Console explizit den Formfaktor „Google Play-Spiele auf dem PC“ hinzu. Wenn Sie nicht auf diesen Tab zugreifen können, wenden Sie sich an Ihren Play-Partner, damit Ihr Konto einer Zulassungsliste hinzugefügt wird.
  • PC-Anforderungen konfigurieren: Geben Sie die Hardwareanforderungen (RAM, GPU, Speicher) für Windows-PCs ein. Weitere Informationen finden Sie im Leitfaden zu PC-Anforderungen.
  • Store-Assets hochladen: Lade deine gepackte WAB-Datei in den Produktions-Track hoch und konfiguriere visuelle Assets. Weitere Informationen finden Sie im Leitfaden zum Hochladen von Assets.
  • Für Tests in der Nutzerumgebung veröffentlichen: Wählen Sie in der Google Play Console Veröffentlichen aus. Im Gegensatz zur Android-Version wird durch die Auswahl von Veröffentlichen in der WAB keine öffentliche Veröffentlichung ausgelöst. Stattdessen wird die App für Ihre freigegebenen Testkonten suchbar gemacht, damit Sie nach der Überprüfung durch Google Tests in einer Nutzerumgebung durchführen können.
  • Offiziell veröffentlichen: Google steuert die Veröffentlichung basierend auf dem offiziellen Veröffentlichungsdatum, das du deinem Play-Partner mitgeteilt hast.
  • Tests während der Vorregistrierungsphase: Während der Vorregistrierungsphase müssen Sie interne Tests in einem Land durchführen, das nicht zu den von Ihnen ausgewählten Vorregistrierungsregionen gehört.
  • Beendigung des Installationsprozesses prüfen: Prüfen Sie, ob der primäre Installationsprozess aktiv bleibt, bis alle erforderlichen Registrierungsschlüssel erstellt und registriert wurden. Wenn der Prozess vorzeitig beendet wird, schlägt die Installationsprüfung fehl. Weitere Informationen finden Sie unter Installer publishing.
  • Konsistente Registrierungsstrukturen beibehalten und bei der Deinstallation bereinigen: Google Play Games auf dem PC prüft HKEY_LOCAL_MACHINE vor HKEY_CURRENT_USER und verwendet den ersten übereinstimmenden Wert. Halten Sie die Registrierungsstruktur über Updates und Titel mit gemeinsam genutztem Launcher hinweg konsistent und entfernen Sie Registrierungsschlüssel während der Deinstallation, damit veraltete HKEY_LOCAL_MACHINE-Einträge keine gültigen HKEY_CURRENT_USER-Pfade verdecken. Weitere Informationen finden Sie unter Installer publishing.

Von der API zum SDK migrieren

Die Migration von der API zum SDK ist ein optionaler Schritt. Wenn Sie sich für eine Migration entscheiden, beachten Sie die folgenden Empfehlungen:

  • Alte REST APIs entfernen: Ordnen Sie alte Play Developer API-Aufrufe (z. B. purchases.products.get) den clientseitigen Native SDK-Funktionen zu. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Befehlszeilenargumente prüfen: Befehlszeilenargumente in der SDK-Umgebung können sich von denen in der API-Umgebung unterscheiden. Prüfen Sie, ob Ihr Paket alle Argumente korrekt verarbeitet und übergibt. Weitere Informationen finden Sie unter Bestätigen.
  • Registry-Pfad prüfen: Für eine nahtlose Migration zum Native SDK muss die Registry-Konfiguration mit früheren Versionen übereinstimmen. Weitere Informationen finden Sie im Leitfaden zu WAB-Dateien.

Weitere Informationen