Start-Checkliste

Verwende diese Checkliste, um sicherzustellen, dass dein Spiel alle Anforderungen erfüllt und die Best Practices einhält, bevor du es zur Überprüfung bei Google Play Games auf dem PC einreichst.

Projekt einrichten und konfigurieren

  • SDK herunterladen und importieren:Integriere das neueste Play Games PC SDK für deine Umgebung. Weitere Informationen findest du im Unity-Leitfaden oder im C++ Leitfaden.
  • Anwendungsmanifest erstellen: Erstelle eine manifest.xml Datei, in der <PackageName> deinem beanspruchten Play Console-Paket zugeordnet wird. Weitere Informationen findest du im Manifest-Leitfaden.
  • Ausführbare Datei digital signieren:Signiere dein Spiel mit einer Authenticode-Digitalsignatur und schütze das Zertifikat für alle zukünftigen Updates. Du kannst diesen Schritt zwar während der lokalen Entwicklung überspringen, indem du den Entwicklermodus aktivierst, aber du musst deine endgültige Binärdatei mit einem tatsächlichen Produktionszertifikat einer bekannten Zertifizierungsstelle signieren. Weitere Informationen findest du unter Spiel digital signieren.
  • Zertifikat formatieren und senden: Sende die Zertifikatsinformationen an deinen Google-Ansprechpartner. Die Zertifikatsdatei sollte nur zertifikatsbezogene Informationen enthalten. Prüfe, ob alle nicht zertifikatsbezogenen Blöcke entfernt wurden. Du kannst OpenSSL verwenden, um DER/CER-Dateien in das erforderliche PEM-Format zu konvertieren.

APIs und Funktionen einbinden

  • SDK initialisieren:Implementiere die SDK-Initialisierungslogik, z. B. InitializeAsync, während des Starts, bevor du andere Funktionen verwendest. Weitere Informationen findest du im Leitfaden zur Initialisierung.
  • Nahtlose Anmeldung implementieren:Authentifiziere Spieler automatisch mit dem Play Games-Clientkonto über die Recall API. Weitere Informationen findest du im Leitfaden zur nahtlosen Anmeldung.
  • Play Integrity einbinden:Verwende IntegrityClient, um Tokens anzufordern und die Legitimität von Spielsitzungen in deinem Backend zu überprüfen. Weitere Informationen findest du im Play Integrity-Leitfaden.
  • Play Install Referrer hinzufügen:Binde die Install Referrer API ein, wenn du Quellen für die Nutzerakquise für PC-Nutzer erfassen musst. Weitere Informationen findest du im Install Referrer-Leitfaden.
  • Initialisierungsfehler behandeln:Um das SDK zu verwenden, rufe GooglePlayInitialize (C++) oder GooglePlayInitialization.InitializeAsync (C#) auf, um die API zu initialisieren. Du musst diesen Aufruf ausführen und prüfen, ob der Rückruf für die Fortsetzung mit InitializeResult::ok() (C++) abgeschlossen wird oder Result.IsOk (C#) true zurückgibt, bevor du eine andere API verwenden kannst.
  • Obligatorisches Herunterfahren behandeln:Behandle kActionRequiredShutdownClientProcess, indem du den Clientprozess so schnell wie möglich herunterfährst.
  • Anforderungen für die Installation von Google Play Games behandeln:Behandle kSdkRuntimeUnavailable, indem du Nutzer darüber informierst, dass Google Play Games und die SDK-Laufzeitumgebung installiert sein müssen, um fortzufahren.
  • Google Play Games-Updates behandeln:Behandle kSdkRuntimeUpdateRequired, indem du Nutzer darüber informierst, dass ein Update der Google Play Games-Laufzeitumgebung erforderlich ist.

Play Billing implementieren

  • Kaufarten prüfen:Bestätige, dass dein Spiel nur auf In-App-Käufen basiert, da wiederkehrende Zahlungen und Abos nicht unterstützt werden. Weitere Informationen findest du in den FAQs zur Abrechnung.
  • Produktdetails abfragen:Verwende QueryProductDetails, um lokalisierte Store-Daten abzurufen. Wenn du mehr als 50 Produkte hast, teile die Anfrage in mehrere Aufrufe auf. Weitere Informationen findest du im Leitfaden zum Abfragen von Produkten.
  • Kaufvorgang starten:Verwende LaunchPurchaseFlow, um Transaktionen nativ zu verarbeiten. Ein Timeout-Fehler von fünf Minuten tritt auf, wenn du den Zahlungsbrowser schließt, ohne zu bezahlen. Weitere Informationen findest du im Leitfaden zum Kaufvorgang.
  • Vorhandene Käufe wiederherstellen:Rufe beim Start und im Vordergrund QueryPurchases auf, um nicht bestätigte geräteübergreifende Käufe zu erfassen. Weitere Informationen findest du im Leitfaden zum Wiederherstellen von Käufen.
  • Backend-Verarbeitung sichern:Überprüfe das purchaseToken in deinem Backend, bevor du Berechtigungen gewährst und mit AcknowledgePurchase oder ConsumePurchase abschließt. Weitere Informationen findest du im Leitfaden zur sicheren Verarbeitung.

Im Entwicklermodus testen und QA vor der Einführung durchführen

  • Im Entwicklermodus testen: Füge <IsDeveloperMode>true</IsDeveloperMode> zu deinem Manifest hinzu und konfiguriere deine GUID für den Early Access-Partner für lokale Tests in der integrierten Entwicklungsumgebung (IDE). Wenn du keine GUID für den Early Access-Partner hast, fülle das Formular für die Interessenbekundung aus.
  • Käufe im Entwicklermodus verwalten:Wenn du Käufe im Entwicklermodus testest, musst du den Kauf innerhalb von drei Minuten abschließen, um automatische Erstattungen zu vermeiden. Weitere Informationen findest du in den FAQs zu Tests.
  • Entwicklermodus entfernen: Du musst das Tag <IsDeveloperMode> so schnell wie möglich entfernen, bevor du deinen Release-Build verpackst. Weitere Informationen findest du im Leitfaden zum Entwicklermodus.
  • Argumente mit Launchern von Drittanbietern weiterleiten:Übergebe alle unbekannten Befehlszeilenargumente, die der Launcher vom Google Play Games-Client erhält, direkt an den erstellten Spielprozess. Weitere Informationen findest du im Leitfaden zu mehreren Prozessen.
  • Mit einem VPN testen:Wenn du aus einer nicht unterstützten Region testest, verwende ein VPN (Virtual Private Network) mit aktiviertem TUN-Modus, um eine unterstützte IP-Adresse zu erhalten. Weitere Informationen findest du in den FAQs zu VPN-Tests.
  • Desktopverknüpfungen unterstützen: Informationen zur nahtlosen Unterstützung von Verknüpfungen findest du in den FAQs zu Verknüpfungen unter Verknüpfungsausführung. Wenn du das Spiel oder einen Launcher eines Drittanbieters direkt über eine Verknüpfung startest, kann dies zu Initialisierungsfehlern führen.

Spiel verpacken, testen und veröffentlichen

  • WAB verpacken:Verwende das Play Publishing Tool, um dein Spiel in ein Windows App Bundle (WAB) zu verpacken. Die WAB-Datei darf die Dateigrößenbeschränkung von 10 GB nicht überschreiten. Weitere Informationen findest du im Leitfaden zum Verpacken.
  • Installationsprogramme für Launcher von Drittanbietern einreichen:Wenn du einen Launcher eines Drittanbieters verwendest, reiche das Installationsprogramm im WAB ein. Weitere Informationen findest du im Leitfaden zur Veröffentlichung von Installationsprogrammen.
  • Spiel und Launcher oder Installationsprogramm aktualisieren:Der Inhalt deines Pakets, einschließlich der Installationsprogramme für Launcher, muss selbst aktualisierbar sein. Verwalte alle Ressourcen, die dein Spiel benötigt, einschließlich der Aktualisierung des Launchers selbst.
  • Startinformationen an Google weitergeben:Wende dich an deinen Play-Partner und teile ihm den Paketnamen, die Startländer (mit ISO-2-Zeichen-Codes, z. B. DE, AT, CH) sowie das Startdatum und die Startzeit in koordinierter Weltzeit (UTC) mit.
  • Testzugriff einrichten:Gib eine externe Google-Gruppe an, die einer Zulassungsliste für Tests, Dokumentation und Google Drive-Zugriff hinzugefügt werden soll. Teile deinem Play-Partner eine E-Mail-Liste mit Testkonten mit, 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 Games auf dem PC“ hinzu. Wenn du nicht auf diesen Tab zugreifen kannst, wende dich an deinen Play-Partner, um dein Konto einer Zulassungsliste hinzuzufügen.
  • PC-Anforderungen konfigurieren: Gib die Hardwareanforderungen (RAM, GPU, Speicher) für Windows-PCs ein. Weitere Informationen findest du im Leitfaden zu PC-Anforderungen.
  • Store-Assets hochladen:Lade deine verpackte WAB-Datei in den Produktions-Track hoch und konfiguriere visuelle Assets. Weitere Informationen findest du im Leitfaden zum Hochladen von Assets.
  • Für Tests in der Nutzerumgebung veröffentlichen:Wähle in der Google Play Console Veröffentlichen aus. Im Gegensatz zur Android-Version wird durch die Auswahl von Veröffentlichen für das WAB keine öffentliche Veröffentlichung ausgelöst. Stattdessen wird die App für deine freigegebenen Testkonten durchsuchbar, damit nach der Überprüfung durch Google Tests in einer Nutzerumgebung durchgeführt werden können.
  • Offizieller Start:Google steuert den Start basierend auf dem offiziellen Startdatum, das du deinem Play-Partner mitgeteilt hast.

Von der API zum SDK migrieren

Die Migration von der API zum SDK ist optional. Wenn du migrieren möchtest, befolge diese Empfehlungen:

  • Legacy-REST-APIs entfernen:Ordne Legacy-Aufrufe der Play Developer API (z. B. purchases.products.get) den clientseitigen Native SDK-Funktionen zu. Weitere Informationen findest du im Migrationsleitfaden.
  • Befehlszeilenargumente überprüfen:Befehlszeilenargumente in der SDK-Umgebung können sich von denen in der API-Umgebung unterscheiden. Prüfe, ob dein Paket alle Argumente korrekt verarbeitet und übergibt. Weitere Informationen findest du unter Überprüfen.
  • Registrierungspfad überprüfen:Für eine nahtlose Migration zum Native SDK muss die Registrierungskonfiguration mit früheren Versionen übereinstimmen. Weitere Informationen findest du im Leitfaden zur WAB-Datei.

Siehe auch