Start-Checkliste

Anhand dieser Checkliste können Sie prüfen, ob Ihr Spiel alle Anforderungen erfüllt und den Best Practices entspricht, bevor Sie es zur Überprüfung für Google Play Games auf dem PC einreichen.

Projekt einrichten und konfigurieren

  • SDK herunterladen und importieren:Integrieren Sie das neueste Play Games PC SDK für Ihre Umgebung. Weitere Informationen finden Sie im Unity-Leitfaden oder C++-Leitfaden.
  • Anwendungsmanifest erstellen: Erstellen Sie eine manifest.xml Datei, in der das <PackageName> Ihrem beanspruchten Play Console-Paket zugeordnet wird. Weitere Informationen finden Sie im Leitfaden zum Manifest.
  • Ausführbare Datei digital signieren:Signieren Sie Ihr Spiel mit einer Authenticode-Digitalsignatur und bewahren Sie das Zertifikat für alle zukünftigen Updates auf. Sie können diesen Schritt zwar während der lokalen Entwicklung überspringen, indem Sie den Entwicklermodus aktivieren, aber Sie müssen Ihre endgültige Binärdatei 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, während des Starts, bevor Sie andere Funktionen verwenden. Weitere Informationen finden Sie im Leitfaden zur Initialisierung.
  • Nahtlose Anmeldung implementieren:Authentifizieren Sie Spieler automatisch mit dem Play Games-Clientkonto über die Recall API. Weitere Informationen finden Sie unter dem Leitfaden zur nahtlosen Anmeldung.
  • Play Integrity einbinden:Verwenden Sie IntegrityClient, um Tokens anzufordern und die Legitimität von Spielsitzungen in Ihrem Backend zu überprüfen. Weitere Informationen finden Sie im Leitfaden zu Play Integrity.
  • Play Install Referrer hinzufügen:Binden Sie die Install Referrer API ein, wenn Sie Quellen für die Nutzerakquise für PC-Nutzer erfassen müssen. Weitere Informationen finden Sie im Leitfaden zu Install Referrer.
  • Initialisierungsfehler behandeln:Rufen Sie GooglePlayInitialize (C++) oder GooglePlayInitialization.InitializeAsync (C#) auf, um die API zu initialisieren. Sie müssen diesen Aufruf ausführen und prüfen, ob der Rückruf für die Fortsetzung mit InitializeResult::ok() (C++) oder Result.IsOk (C#) abgeschlossen wird und true zurückgibt, bevor Sie eine andere API verwenden können.
  • Obligatorisches Herunterfahren behandeln:Behandeln Sie kActionRequiredShutdownClientProcess, indem Sie den Clientprozess so schnell wie möglich herunterfahren.
  • Anforderungen für die Installation von Google Play Games behandeln:Behandeln Sie kSdkRuntimeUnavailable, indem Sie Nutzer darüber informieren, dass Google Play Games und die SDK-Laufzeitumgebung installiert sein müssen, um fortzufahren.
  • Google Play Games-Updates behandeln:Behandeln Sie kSdkRuntimeUpdateRequired, indem Sie Nutzer darüber informieren, dass ein Update der Google Play Games-Laufzeitumgebung erforderlich ist.

Play Billing implementieren

  • Kaufarten prüfen:Bestätigen Sie, dass Ihr 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 zum Abfragen von Produkten.
  • Kaufvorgang starten:Verwenden Sie LaunchPurchaseFlow, um Transaktionen nativ zu verarbeiten. Wenn Sie den Zahlungsbrowser schließen, ohne zu bezahlen, tritt ein Timeout-Fehler nach fünf Minuten auf. Weitere Informationen finden Sie im Leitfaden zum Kaufvorgang.
  • Vorhandene Käufe wiederherstellen:Rufen Sie beim Start und im Vordergrund QueryPurchases auf, um nicht bestätigte geräteübergreifende Käufe zu erfassen. Weitere Informationen finden Sie im Leitfaden zum Wiederherstellen von Käufen.
  • Backend-Verarbeitung sichern:Validieren Sie das purchaseToken in Ihrem Backend, bevor Sie Berechtigungen gewähren und den Vorgang mit AcknowledgePurchase oder ConsumePurchase abschließen. Weitere Informationen finden Sie im Leitfaden zur sicheren Verarbeitung.
  • Verzögerung bei der Weitergabe des Lizenzschlüssels berücksichtigen:Wenn Sie neue Abrechnungs- oder Lizenzschlüssel in der Play Console konfigurieren, warten Sie einige Stunden, bis der Backend-Cache in allen Commerce-Bereitstellungsumgebungen synchronisiert wurde, bevor Sie Live-Kauftests durchführen. Bei Käufen, die vor Abschluss der Synchronisierung versucht werden, wird der Fehlercode 6 zurückgegeben.

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

  • Im Entwicklermodus testen: Fügen Sie <IsDeveloperMode>true</IsDeveloperMode> zu Ihrem Manifest hinzu und konfigurieren Sie Ihre GUID für den Early-Access-Partner für lokale Tests in der integrierten Entwicklungsumgebung (IDE). Wenn Sie keine GUID für den Early-Access-Partner haben, füllen Sie das Formular für die Interessenbekundung aus.
  • Käufe im Entwicklermodus verwalten:Wenn Sie Käufe im Entwicklermodus testen, müssen Sie den Kauf innerhalb von drei Minuten abschließen, um automatische Erstattungen zu vermeiden. 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:Übergeben Sie alle unbekannten Befehlszeilenargumente, die der Launcher vom Google Play Games-Client erhält, direkt an den erstellten Spielprozess. Weitere Informationen finden Sie im Leitfaden für mehrere Prozesse.
  • Mit einem VPN testen:Wenn Sie aus einer nicht unterstützten Region testen, verwenden Sie ein VPN mit aktiviertem TUN-Modus, um eine unterstützte IP-Adresse zu erhalten. Weitere Informationen finden Sie in den FAQs zu VPN-Tests.
  • Desktopverknüpfungen unterstützen: Informationen zur nahtlosen Unterstützung von 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 verpacken:Verwenden Sie das Play Publishing Tool, um Ihr Spiel in ein Windows App Bundle (WAB) zu verpacken. Die WAB-Datei darf die Dateigrößenbeschränkung von 10 GB nicht überschreiten. Weitere Informationen finden Sie im Leitfaden zum Verpacken.
  • Prüfen, ob eine Erhöhung der Berechtigungen erforderlich ist:Wenn Ihr Installationsprogramm, Launcher oder 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 gesetzt haben. Andernfalls werden sie nicht mit Administratorberechtigungen ausgeführt, was zu einem Startfehler führt. Weitere Informationen finden Sie unter WAB-Konfigurationsdateiformat für weitere Details.
  • Installationsprogramme für Launcher von Drittanbietern einreichen:Wenn Sie einen Launcher eines Drittanbieters 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 Bef0ehlszeilenargument --g_session_token=<token> extrahiert und damit das Spiel startet. Achten Sie darauf, dass Ihr Installationsprogramm den Fallback-Fall behandelt, in dem das Token nicht vorhanden ist. Weitere Informationen finden Sie in den FAQs zum Launcher.
  • Spiel und Launcher oder Installationsprogramm aktualisieren:Der Inhalt Ihres Pakets, einschließlich der Installationsprogramme für den Launcher, muss automatisch aktualisiert werden können. Verwalten Sie alle Ressourcen, die Ihr Spiel benötigt, einschließlich der Aktualisierung des Launchers selbst.
  • Startinformationen an Google weitergeben:Wenden Sie sich an Ihren Play-Partner und teilen Sie ihm den Paketnamen, die Startländer (mit ISO-2-Ländercodes, z. B. DE, AT, CH) sowie das Startdatum und die Startzeit in koordinierter Weltzeit (UTC) mit.
  • Testzugriff einrichten:Geben Sie eine externe Google-Gruppe an, die einer Zulassungsliste für Tests, Dokumentation und Google Drive-Zugriff hinzugefügt werden soll. Teilen Sie Ihrem Play-Partner eine E-Mail-Liste mit Testkonten mit, da Test-Tracks in der Play Console für PC nicht unterstützt werden.
  • PC-Formfaktor hinzufügen:Fügen Sie Ihrer App in der Google Play Console explizit den Formfaktor „Google Play Games auf dem PC“ hinzu. Wenn Sie nicht auf diesen Tab zugreifen können, bitten Sie Ihren Play-Partner, Ihr Konto einer Zulassungsliste hinzuzufügen.
  • 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:Laden Sie Ihre verpackte WAB-Datei in den Produktions-Track hoch und konfigurieren Sie 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 Auswahl von Veröffentlichen für das WAB keine öffentliche Veröffentlichung ausgelöst. Stattdessen wird die App für Ihre freigegebenen Testkonten durchsuchbar, damit nach der Überprüfung durch Google Tests in einer Nutzerumgebung durchgeführt werden können.
  • Offiziell starten:Google steuert den Start anhand des offiziellen Startdatums, das Sie Ihrem Play-Partner mitgeteilt haben.
  • Tests während der Vorregistrierungsphase:Während der Vorregistrierungsphase müssen Sie interne Tests in einem Land durchführen, das nicht in Ihren ausgewählten Vorregistrierungsregionen enthalten ist.
  • Beendigung des Installationsprogramms 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 Veröffentlichung von Installationsprogrammen.

Von der API zum SDK migrieren

Die Migration von der API zum SDK ist optional. Wenn Sie migrieren möchten, empfehlen wir Folgendes:

  • Legacy-REST-APIs entfernen:Ordnen Sie Legacy-Aufrufe der Play Developer API (z. B. purchases.products.get) den clientseitigen Native SDK-Funktionen zu. Weitere Informationen finden Sie im Migrationsleitfaden.
  • 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 weitergibt. Weitere Informationen finden Sie unter Prüfen.
  • Registrierungspfad prüfen:Für eine nahtlose Migration zum Native SDK muss die Registrierungskonfiguration mit früheren Versionen übereinstimmen. Weitere Informationen finden Sie im Leitfaden zur WAB-Datei.

Weitere Informationen