Start-Checkliste

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

Projekt einrichten und konfigurieren

  • SDK herunterladen und importieren:Integrieren Sie das aktuelle Play Games 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> Ihrem beanspruchten Play Console-Paket zugeordnet wird. Weitere Informationen finden Sie im Manifest-Leitfaden.
  • Ausführbare Datei digital signieren:Signieren Sie Ihr Spiel mit einer Authenticode-Signatur und schützen Sie das Zertifikat für alle zukünftigen Updates. Sie können diesen Schritt zwar während der lokalen Entwicklung überspringen, indem Sie den Entwicklermodus aktivieren, aber Sie müssen Ihr endgültiges Binärprogramm 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 Blöcke, die nicht mit Zertifikaten zusammenhängen, 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 Logik zur SDK-Initialisierung, z. B. InitializeAsync, beim Start, bevor Sie andere Funktionen verwenden. Weitere Informationen finden Sie im Initialisierungsleitfaden.
  • Nahtlose Anmeldung implementieren:Spieler automatisch über das Play Games-Kundenkonto mithilfe der Recall API authentifizieren. Weitere Informationen finden Sie im Leitfaden zur nahtlosen Anmeldung.
  • Play Integrity API einbinden:Verwenden Sie die IntegrityClient, um Tokens anzufordern und die Rechtmäßigkeit von Spielsitzungen in Ihrem Backend zu bestätigen. Weitere Informationen finden Sie im Play Integrity-Leitfaden.
  • Play Install Referrer API hinzufügen:Binden Sie die Install Referrer API ein, wenn Sie Quellen für die Nutzerakquisition für PC-Spiele erfassen möchten. Weitere Informationen finden Sie im Install Referrer-Leitfaden.
  • Initialisierungsfehler behandeln:Rufen Sie zum Verwenden des SDK GooglePlayInitialize (C++) oder GooglePlayInitialization.InitializeAsync (C#) auf, um die API zu initialisieren. Sie müssen diese Funktion aufrufen und prüfen, ob der Fortsetzungs-Callback mit InitializeResult::ok() (C++) abgeschlossen wird oder Result.IsOk (C#) true zurückgibt, bevor Sie eine andere API verwenden können.
  • Obligatorisches Herunterfahren verarbeiten:Verarbeite kActionRequiredShutdownClientProcess, indem du den Clientprozess so schnell wie möglich herunterfährst.
  • Installationsanforderungen von Google Play Games berücksichtigen:Behandle 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 Google Play Games-Laufzeitupdate erforderlich ist.

Play Billing implementieren

  • Kaufarten prüfen:Prüfen Sie, ob Ihr Spiel nur auf In-App-Käufen basiert, da wiederkehrende Zahlungen und Abos nicht unterstützt werden. Weitere Informationen finden Sie in den FAQ 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. Ein Timeout-Fehler von fünf Minuten tritt auf, wenn Sie den Zahlungsbrowser schließen, ohne zu bezahlen. Weitere Informationen finden Sie im Leitfaden zum Kaufvorgang.
  • Vorhandene Käufe wiederherstellen:Rufen Sie QueryPurchases beim Start und im 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:Prüfe das purchaseToken in deinem Backend, bevor du Berechtigungen gewährst und mit AcknowledgePurchase oder ConsumePurchase abschließt. Weitere Informationen finden Sie im Leitfaden zur sicheren Verarbeitung.
  • Verzögerung bei der Übertragung von Lizenzierungsschlüsseln berücksichtigen:Wenn Sie neue Abrechnungs- oder Lizenzierungsschlüssel in der Play Console konfigurieren, kann es mehrere Stunden dauern, bis der Backend-Cache in den verschiedenen Commerce-Umgebungen synchronisiert ist. Führen Sie erst dann Live-Kauftests durch. 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> Ihrem Manifest hinzu und konfigurieren Sie Ihre Early Access-Partner-GUID für lokale Tests in der integrierten Entwicklungsumgebung (IDE). Wenn Sie keine GUID für den Vorabzugriffspartner haben, füllen Sie dieses Formular aus.
  • Käufe im Entwicklermodus verwalten:Wenn Sie Käufe im Entwicklermodus testen, müssen Sie den Kauf innerhalb von drei Minuten verbrauchen, um automatische Erstattungen zu vermeiden. Weitere Informationen finden Sie in den FAQs zum Testen.
  • Entwicklermodus entfernen:Sie müssen das <IsDeveloperMode>-Tag so bald wie möglich entfernen, bevor Sie Ihren Release-Build verpacken. Weitere Informationen finden Sie im Leitfaden für den Entwicklermodus.
  • Argumente über Drittanbieter-Launcher weiterleiten:Alle unbekannten Befehlszeilenargumente, die der Launcher vom Google Play Games-Client empfängt, werden direkt an den gestarteten Spielprozess übergeben. 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 FAQ zum VPN-Test.
  • Desktopverknüpfungen unterstützen:Informationen zur nahtlosen Unterstützung von Verknüpfungen finden Sie in den FAQs zur Ausführung von Verknüpfungen. Wenn Sie das Spiel oder einen Drittanbieter-Launcher direkt über eine Verknüpfung starten, kann dies zu Initialisierungsfehlern führen.

Spiel verpacken, testen und veröffentlichen

  • WAB packen:Verwenden Sie das Play Publishing Tool, um Ihr Spiel in ein Windows App Bundle (WAB) zu packen. Die WAB-Datei darf die Dateigrößenbeschränkung von 10 GB für die Veröffentlichung von Installationsprogrammen und 200 GB für die verwaltete Veröffentlichung über Play nicht überschreiten. Weitere Informationen finden Sie im Verpackungsleitfaden.
  • Neueste SDKs und Tools verwenden:Kompilieren und verpacken Sie Ihren Release mit den aktuellen Versionen des Play Games PC SDK, des Play Games PC Unity SDK, des Play PC-Entwicklertools und des Play Publishing-Tools.
  • Bestätigen, ob eine Erhöhung der Berechtigungen erforderlich ist:Wenn Ihr Installations-, 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 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 dafür im WAB ein. Weitere Informationen finden Sie im Leitfaden zum Veröffentlichen von Installationsprogrammen.
  • Sitzungstoken für die automatische Wiedergabe verarbeiten:Wenn Sie die automatische Wiedergabe aktivieren, indem Sie acceptsCommandLineArguments="true" in play_publishing_config.xml festlegen, prüfen Sie, ob Ihr Installationsprogramm das --g_session_token=<token>-Befehlszeilenargument extrahiert und damit das Spiel startet. Achten Sie darauf, dass Ihr Installationsprogramm den Fallback-Fall abdeckt, in dem das Token nicht vorhanden ist. Weitere Informationen finden Sie in den Launcher-FAQs.
  • Spiel und Launcher oder Installationsprogramm aktualisieren:Der Inhalt Ihres Pakets, einschließlich Launcher-Installationsprogramme, muss selbst aktualisierbar sein. Alle Ressourcen verwalten, die für Ihr Spiel erforderlich sind, einschließlich der Aktualisierung des Launchers selbst.
  • Startinformationen mit Google teilen:Wenden Sie sich an Ihren Play-Partner und teilen Sie ihm Ihren Paketnamen, die Startländer (mit zweistelligen ISO-Codes, z. B. US, CA, MX) sowie das Startdatum und die Startzeit in koordinierter Weltzeit (UTC) mit.
  • Testzugriff einrichten:Geben Sie eine externe Google-Gruppe an, die auf die Zulassungsliste für Tests, Dokumentation und Google Drive-Zugriff gesetzt werden soll. Geben Sie eine E-Mail-Liste mit Testkonten an Ihren Play-Partner weiter, da Test-Tracks in der Play Console für PCs 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, wenden Sie sich an Ihren Play-Partner, um Ihr Konto auf eine Zulassungsliste setzen zu lassen.
  • PC-Anforderungen konfigurieren:Geben Sie die Hardwareanforderungen (RAM, GPU, Speicher) für Windows-PCs ein. Weitere Informationen finden Sie im Leitfaden zu PC-Anforderungen.
  • Shop-Assets hochladen:Laden Sie Ihre verpackte WAB-Datei in den Produktions-Track hoch und konfigurieren Sie visuelle Assets. Weitere Informationen finden Sie in der Anleitung zum Hochladen von Assets.
  • Für Nutzertests 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 im WAB kein öffentlicher Release ausgelöst. Stattdessen wird die App für Ihre freigegebenen Testkonten durchsuchbar, damit Sie nach dem Überprüfungsprozess von Google Tests in einer Nutzerumgebung durchführen können.
  • Offizieller Launch:Google steuert den Launch basierend auf dem offiziellen Launchtermin, den Sie Ihrem Play-Partner mitgeteilt haben.
  • Test während der Vorregistrierung:Während der Vorregistrierungsphase müssen Sie interne Tests in einem Land durchführen, das nicht in den von Ihnen ausgewählten Vorregistrierungsregionen enthalten ist.
  • Beenden des Installationsvorgangs überprüfen:Der primäre Installationsvorgang muss aktiv bleiben, bis alle erforderlichen Registrierungsschlüssel erstellt und registriert wurden. Wenn der Prozess vorzeitig beendet wird, schlägt die Installationsüberprüfung fehl. 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 die Migration entscheiden, sollten Sie Folgendes beachten:

  • 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 richtig verarbeitet und übergibt. Weitere Informationen finden Sie unter Bestätigen.
  • Registrierungspfad überprüfen:Für eine reibungslose Migration zum Native SDK muss die Registrierungskonfiguration mit früheren Versionen übereinstimmen. Weitere Informationen finden Sie im Leitfaden für WAB-Dateien.

Weitere Informationen