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 Manifestleitfaden.
  • 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-Spiele-Clientkonto 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 überprüfen. 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 erfassen möchten. Weitere Informationen finden Sie im Install Referrer-Leitfaden.
  • Initialisierungsfehler beheben:Rufen Sie zum Verwenden des SDK GooglePlayInitialize (C++) oder GooglePlayInitialization.InitializeAsync (C#) auf, um die API zu initialisieren. Sie müssen diesen Aufruf ausführen 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:Behandeln Sie kSdkRuntimeUnavailable, indem Sie Nutzer darüber informieren, 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 In-App-Käufe nutzt, 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 Fehler mit einem fünfminütigen Zeitlimit 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üfen Sie die purchaseToken in Ihrem Backend, bevor Sie Berechtigungen gewähren und die Transaktion mit AcknowledgePurchase oder ConsumePurchase abschließen. Weitere Informationen finden Sie im Leitfaden zur sicheren Verarbeitung.

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 GUID für den Vorabzugriffspartner für lokale Tests in der integrierten Entwicklungsumgebung (IDE). Wenn Sie keine GUID für den Vorabzugriff haben, füllen Sie das Antragsformular 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 FAQ 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 (Virtual Private Network) 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 zu 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 verpacken:Verwenden Sie das Play Publishing Tool, um Ihr Spiel in ein Windows App Bundle (WAB) zu verpacken. Die WAB-Datei darf nicht größer als 10 GB sein. Weitere Informationen finden Sie im Verpackungsleitfaden.
  • 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.
  • Spiel und Launcher oder Installationsprogramm aktualisieren:Die Inhalte Ihres Pakets, einschließlich Launcher-Installationsprogramme, müssen 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 ISO-2-Zeichen-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 eine 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 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, bitten Sie Ihren Play-Partner, Ihr Konto auf eine Zulassungsliste zu setzen.
  • PC-Anforderungen konfigurieren:Geben Sie die Hardwareanforderungen (RAM, GPU, Speicher) für Windows-PCs ein. Weitere Informationen finden Sie im Leitfaden zu PC-Anforderungen.
  • Händler-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 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 in der WAB keine öffentliche Version 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.

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, beachten Sie die folgenden Empfehlungen:

  • Legacy-REST-APIs entfernen:Ordnen Sie Legacy-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.
  • 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.

Siehe auch