In diesem Dokument finden Sie Antworten auf häufig gestellte Fragen zu SDKs und zur Veröffentlichung für Google Play Games auf dem PC.
Monetarisierung
Warum schlägt mein Kaufvorgang mit dem Fehlercode 6 fehl, nachdem ich einen neuen Abrechnungs- oder Lizenzschlüssel hinzugefügt habe?
Bei neu generierten Lizenzschlüsseln in der Google Play Console kommt es im Commerce-Backend zu einer mehrstündigen Verzögerung beim Caching und der Weitergabe, bevor die internen Caches von Google Play in allen Bereitstellungsumgebungen synchronisiert werden. Auch wenn Ihr Spielclient Produktdetails erfolgreich abfragen kann, schlagen Kaufanfragen bis zum Abschluss der Synchronisierung mit dem Fehlercode 6 fehl. Warten Sie nach dem Hochladen oder Aktualisieren Ihres Lizenzschlüssels einige Stunden, bevor Sie Käufe testen.
Kann ich den Kaufvorgang ohne Backend-Server verwenden?
Aus Sicherheitsgründen empfiehlt Google die Verwendung eines Backend-Servers.
Weitere Informationen finden Sie unter Ohne Backend-Server verarbeiten.
Sind bestehende API-basierte Zahlungssysteme nach der Integration des SDK für Google Play Games auf dem PC zulässig?
Alle Zahlungen müssen über das SDK von Google Play Spiele auf dem PC mit Google Play Billing abgewickelt werden. Sie können Ihre vorhandene API-basierte Zahlungsmethode nicht im selben Spiel verwenden.
Wie können wir Käufe im Entwicklermodus verbrauchen?
Käufe müssen im Entwicklermodus innerhalb von 3 Minuten abgewickelt werden, da sie ansonsten erstattet werden.
Werden wiederkehrende Zahlungen oder Abos unterstützt?
Nicht für die unmittelbare Zukunft. Sie können uns aber gern konkrete Anwendungsfälle nennen, die wir in unsere zukünftige Roadmap aufnehmen können.
Was ist der Abrechnungsfehler in meinen Kaufaufrufen?
BillingError ist die Antwort des Zahlungsergebnisses. LaunchPurchaseFlow wird sofort zurückgegeben, ohne zu blockieren. Sie müssen jedoch den Callback überwachen, um zu wissen, wann der Vorgang abgeschlossen ist, und um das Ergebnis zu erfassen.
Wie kann ich die clientseitige Bestätigung von Käufen verwenden?
Wir empfehlen, den serverseitigen Kauf und das zugehörige Überprüfungsverfahren zu verwenden. Damit Käufe über deine Client-App verarbeitet werden können, muss dein Spiel auf einer Zulassungsliste stehen. Wende dich an deinen Google-Partner, wenn dein Spiel Zugriff benötigt. Weitere Informationen finden Sie unter Ohne Backend-Server verarbeiten.
Welche API-Limits gelten für die Abfrage von Produktdetails?
Die maximale Anzahl von Produkten, die in einem einzelnen Aufruf der
QueryProductDetailsAPI abgefragt werden können, beträgt 50. Wenn Sie dieses Limit überschreiten, müssen Sie die Anfrage in mehrere Aufrufe aufteilen.Warum schlagen Produktabfragen oder Kaufvorgänge mit internen Fehlern fehl, wenn viele Produkt-SKUs geladen werden?
Wenn Sie zu viele Produkt-SKUs gleichzeitig abfragen oder
QueryProductDetailsin C++ oderQueryProductDetailsAsyncin Unity in kurzer Zeit zu oft hintereinander aufrufen, z. B. wenn Sie Dutzende von Batchaufrufen in einer engen Schleife senden oder eine neueBillingClient-Instanz pro Batch erstellen, kann dies zu einer Überlastung der lokalen IPC- und Backend-Verbindungen führen. Wenn diese Verbindungen zurückgesetzt werden, schlagen Abfragen von Produktdetails fehl und Ihr Spiel kann die für den Start eines Kaufvorgangs erforderlichen Angebotstokens nicht abrufen.Beachten Sie die folgenden Best Practices, um diese Fehler beim Laden Ihres Katalogs zu vermeiden:
- Beachten Sie die unterstützte Anzahl von Produkten pro Aufruf: Fragen Sie nicht mehr als 50 Produkte in einem einzelnen
QueryProductDetails- oderQueryProductDetailsAsync-Aufruf ab und speichern Sie die zurückgegebeneProductDetailsim Cache, anstatt den gesamten Katalog wiederholt abzufragen. Weitere Informationen zu unterstützten Batchlimits und zum Abfragen von Produktdetails finden Sie in der vorherigen Frage zu API-Limits, unter Verfügbare Produkte anzeigen für C++ und unter Produktdetails abfragen für Unity. - Vermeiden Sie es, die APIs in kurzer Zeit zu oft hintereinander aufzurufen: Senden Sie nicht mehrere Produktabfrage-Batches gleichzeitig oder nacheinander ohne zeitlichen Abstand. Verwenden Sie eine einzelne
BillingClient-Instanz wieder, serialisieren Sie Anfragen oder begrenzen Sie die Nebenläufigkeit auf zwei oder drei gleichzeitige Aufrufe und fügen Sie eine kurze Verzögerung zwischen aufeinanderfolgenden Batches hinzu. - Auf das neueste SDK aktualisieren: Aktualisieren Sie Ihre Integration auf die neueste Version des Google Play Spiele auf dem PC SDK, Version 26.9.261.0 für C++ oder 26.9.261.0 für Unity, von der Seite Play Spiele auf dem PC SDK-Downloads, damit Ihr Client die neuesten Verbesserungen bei der Abrechnung und IPC-Stabilität enthält.
- Beachten Sie die unterstützte Anzahl von Produkten pro Aufruf: Fragen Sie nicht mehr als 50 Produkte in einem einzelnen
Welche Parameter sind erforderlich, wenn „Query Purchases“ oder „Launch Purchase Flow“ im Billing Client aufgerufen wird?
Die Funktion akzeptiert
QueryPurchasesContinuation, einen Funktions-Callback mit der Signaturstd::function<void(QueryPurchasesResult)>. Der Callback übergibt das Ergebnis mit allenProductPurchaseDetailsan Sie. Diese Informationen sind in den SDK-Headerdateien in der Dateiincludes/billing/models.hverfügbar.Das resultierende
launch_purchase_flow_resulthat die Funktionenok()undcode(). Die Funktionok()gibt zurück, ob der Ablauf erfolgreich ist. Die Funktioncode()gibt das EnumBillingError(includes/billing/enums.h) zurück, das 10 mögliche Fehlerfälle enthält, z. B. „Nutzer hat abgebrochen“ oder „Netzwerkfehler“.Wird eine benutzerdefinierte Reihenfolge für den Start des Kaufvorgangs im Billing Client unterstützt?
Im aktuellen SDK-Design gibt es keine Möglichkeit, eine eigene Nutzlast zu übergeben. Sie können jedoch eine beliebige Kombination aus
obfuscated_account_idundobfuscated_profile_idangeben. Sie können keine, nur eine oder beide Optionen angeben.Das Feld
offer_tokenist erforderlich und gibt das Kaufangebot an, das der Nutzer im Bezahlvorgang kaufen möchte. Derzeit hat jede SKU in Google Play genau ein Angebot (z. B. einen Artikel für 10 $ kaufen). In Zukunft wird das Play Billing-Team mehrere Angebote unterstützen.Damit die Metadaten auch bei Unterbrechungen des Kaufvorgangs zugeordnet werden, speichern Sie die Metadaten vor dem Start des Kaufdialogs auf Ihrem Backend-Server und verknüpfen Sie sie mit der Konto-ID des Nutzers, der gekauften SKU und dem aktuellen Zeitstempel. Weitere Informationen finden Sie unter Kauf mit internen Daten verknüpfen.
Welche Voraussetzungen gelten für den Wechsel von der Google-Abrechnung mit OAuth zur DLL-basierten Google-Abrechnung?
Spiele können weiterhin die OAuth-Anmeldung mit Google verwenden, um das angemeldete Konto zu verwalten. Google empfiehlt jedoch, die alten REST-Abrechnungs-APIs nicht mehr zu verwenden. Der Wechsel von den REST-Abrechnungs-APIs (mit OAuth2-Anmeldung) zum SDK-Ablauf kann ein Vorgang mit Funktions-Flag sein, sodass beide für eine gewisse Zeit nebeneinander existieren können, während das Spiel umgestellt wird.
Wird der API-Aufruf „Kaufvorgang starten“ über einen Webbrowser verarbeitet?
Nein, der Kaufvorgang wird jetzt vollständig im Spiel über ein nahtloses WebView-Overlay abgeschlossen, ohne dass der Spielclient verlassen werden muss.
Muss sich ein Nutzer für jedes Spiel separat anmelden, um einen Kauf zu tätigen?
Das Vordergrundkonto in Google Play Games wird für jede Spielsitzung verwendet, sodass du dich nicht noch einmal anmelden musst. Das Konto, das Sie in Google Play Spiele verwenden, wenn die Spielsitzung beginnt, ist das Konto, über das API-Aufrufe ausgegeben werden. Dieses Konto wird automatisch für den Kaufvorgang verwendet.
Kann ein Spiel gleichzeitig das PC SDK und ältere Zahlungssysteme unterstützen?
Das Zahlungssystem funktioniert je nach Version der Binärdatei des Spiels nach einem dualen Modell. Nutzer mit alten Builds verwenden weiterhin den bestehenden Ablauf, während Nutzer mit neuen Builds auf SDK-basierte Zahlungen umgestellt werden. Nutzer in beiden Zahlungsabläufen koexistieren während der Übergangsphase.
Windows-App-Bundle
Ist das Spielpaket für die Überprüfung erforderlich, wenn ein WAB über einen Launcher eines Drittanbieters eingereicht wird?
Du kannst einfach dein Installationsprogramm einreichen und musst nicht dein gesamtes Spielpaket einreichen. Der Prüfer kann dein Spielpaket über das Installationsprogramm herunterladen.
Gibt es Einschränkungen bei der WAB-Dateigröße?
Für die Veröffentlichung von Installationsprogrammen können Sie eine WAB-Datei mit einer Größe von bis zu 10 GB hochladen. Für die verwaltete Veröffentlichung bei Google Play beträgt die maximale WAB-Dateigröße 200 GB.
Warum wird mein Spiel nach dem Hochladen des WAB nicht installiert oder angezeigt?
Wenn dein Spiel ohne eine bereits vorhandene PC-Version aufgenommen wird (ein „erstmaliges WAB“), wird es möglicherweise automatisch in den Status „Verwaltete Veröffentlichung“ versetzt. Das liegt daran, dass es keine Baseline gibt, die aktualisiert werden könnte. Wenn du das WAB vollständig veröffentlichen und das Spiel zur Installation verfügbar machen möchtest, musst du die Google Play Console aufrufen und die erforderliche Veröffentlichungsaktion manuell ausführen, z. B. auf „Änderungen veröffentlichen“ klicken.
Wie lade ich das WAB für interne Tests hoch?
Teile die Konten auf der Zulassungsliste mit Google, damit Google sie für interne Tests aktivieren kann. Nachdem Google die Liste erhalten hat, sorgt Google dafür, dass sie in den Onboarding-Prozess einbezogen werden.
Wo sollte das WAB-Paket hochgeladen werden?
Sie können das WAB-Paket an dem in der ersten Frage genannten Ort hochladen. Sie können sie jedoch nicht manuell veröffentlichen. Sie müssen den Google-Backend-Mitarbeitern eine genaue UTC-Zeit (bis auf die Stunde) angeben. Google konfiguriert dann den Veröffentlichungszeitplan und sorgt dafür, dass die Veröffentlichung pünktlich erfolgt.
PC SDK
Was sind die Unterschiede zwischen der Legacy API und dem Google Play Spiele auf dem PC SDK?
- Die alte API bietet nur Abrechnungsfunktionen.
- Das PC SDK unterstützt den Google Desktop Service (GDS) und alle PC-Funktionen.
- Für das PC SDK ist keine browserbasierte Google-Anmeldung erforderlich.
Gibt es eine alternative Möglichkeit, das SDK zu initialisieren, indem das Spiel direkt über den Game Launcher gestartet wird, ohne Google Play Spiele auf dem PC zu verwenden?
Ihr Spiel muss über den Google Play Games auf dem PC-Client gestartet werden. Weitere Informationen finden Sie in diesem Entwicklerdokument.
Unterstützt das PC SDK Multibyte-Zeichen in der PEM-Zertifizierungsdatei?
Ja, das SDK unterstützt Multibyte-Zeichen für die Zertifizierung.
Wie verarbeitet das SDK die Anmeldung in einem Google-Konto für mehrere Instanzen oder Konten?
Jeder Spielstart in Google Play Games wird als „Spielsitzung“ behandelt und jeder „Spielsitzung“ kann ein Konto zugeordnet werden. Sie können unterschiedlich sein. Wenn Sie das Spiel also mit Konto A starten, dann zu Konto B wechseln und das Spiel noch einmal starten, können beide gleichzeitig ausgeführt werden.
Funktioniert die Play Install Referrer-Integration mit dem PC SDK?
Das PC SDK (25.5.409.0 und höher) unterstützt die Play Install Referrer API. Weitere Informationen finden Sie unter Play Install Referrer API.
Launcher
Wenn ein Spieler einen Drittanbieter-Launcher anstelle des Google Play-Clients verwendet, wird sein Play Games-Dienste-Konto dann automatisch synchronisiert?
Damit die SDK-Funktionen funktionieren, muss das Spiel direkt über den Google Play Games-Client gestartet werden. Wenn ein anderer Prozess, z. B. ein Installationsprogramm oder eine Launcher-Anwendung, das Spiel startet, muss dieser Prozess selbst über den Google Play Games-Client gestartet werden. Das Spiel muss alle vom Client empfangenen Parameter an den Clientprozess übergeben.
Wie gehe ich mit der Initialisierung um, wenn Google Play Spiele einen Drittanbieter-Launcher startet?
Sie müssen das SDK nicht direkt in Ihren Launcher einbinden. Du musst jedoch alle Befehlszeilenargumente, die der Launcher vom Google Play Games-Client erhält, direkt an den erstellten untergeordneten Prozess (die ausführbare Datei des Spiels) übergeben. Wenn die Initialisierung fehlschlägt (z. B. durch Rückgabe von
kActionRequiredShutdownClientProcess), müssen alle Prozesse, einschließlich des Launchers, beendet werden, damit Google Play Games versuchen kann, das Spiel automatisch wiederherzustellen und neu zu starten. Weitere Informationen finden Sie im Einrichtungsleitfaden unter Schritt 5.Wie kann ich Updates und Wartungsarbeiten für mein Spiel und meinen Launcher nach der Veröffentlichung verwalten?
Nachfolgende Updates und Wartungsarbeiten müssen über Ihren Launcher implementiert werden. Der Google Play Games-Client unterstützt keine Updatefunktionen. Daher muss der Launcher sowohl das Spiel als auch den Launcher selbst aktualisieren können.
Wie erhält das Installationsprogramm das GPG-Sitzungstoken für Auto-Play?
GPG übergibt das Sitzungstoken mit dem Befehlszeilenargument
--g_session_token=<token>an das Installationsprogramm. Dazu müssen SieacceptsCommandLineArguments="true"in Ihrerplay_publishing_config.xmlfestlegen.Das Installationsprogramm ist dafür verantwortlich, dieses Token zu extrahieren und zum Starten des Spiels zu verwenden. Wenn die Tokengenerierung fehlschlägt, startet GPG das Installationsprogramm ohne das Token (Fallback).
Initialisierung
Werden meine Google-Kontodetails synchronisiert, wenn ich ein Spiel über die Google Play Games App starte?
Nachdem das Spiel über den Google Play Games-Client gestartet wurde, wird das Konto automatisch synchronisiert und es ist nicht erforderlich, sich noch einmal über den Google-Anmeldevorgang anzumelden.
Können die Initialisierungsparameter mehrmals verwendet werden?
Dies ist möglich, solange der Google Play Games-Client ausgeführt wird und die Anmeldedaten gültig sind. In Szenarien wie dem im Leitfaden beschriebenen müssen jedoch alle vom Spiel gestarteten Prozesse beendet werden, wenn der Nutzer das Spiel schließt oder das Spiel aufgrund eines SDK-Initialisierungsfehlers wie
kActionRequiredShutdownClientProcessbeendet wird.Gibt es eine Möglichkeit, eine Verknüpfung zu erstellen, um das Spiel direkt zu öffnen?
Sie können den folgenden URI verwenden, um das Spiel direkt zu öffnen:
googleplaygames://launch/?pid=2&id=com.company.gamenameDer URI unterstützt die Erkennung, ob der Google Play Games auf dem PC-Client geöffnet ist. Wenn der Google Play Games-Client nicht geöffnet ist, wird er geöffnet, bevor das Spiel oder der Launcher ausgeführt wird. Sie müssen das Spiel oder den Launcher verwalten, um zu verhindern, dass mehrere Instanzen ausgeführt werden.
Gibt es eine Möglichkeit, die Installation von Google Play Games auf dem PC ohne das SDK zu überprüfen?
Du kannst den Installationsstatus von Google Play Games auf dem PC prüfen, ohne das SDK einzubinden. Dazu musst du nachsehen, ob der folgende Windows-Registrierungsschlüssel vorhanden ist:
HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games ServicesDas Vorhandensein dieses Schlüssels gibt an, dass die Google Play-Spieldienste (erforderlich, um Spiele auf dem PC auszuführen) auf dem Computer installiert sind. Wenn der Schlüssel fehlt, solltest du den Nutzer auf die Installationsseite für Google Play Games auf dem PC verweisen, damit er den Client herunterladen und installieren kann.
Test
Gibt es offene oder geschlossene Testumgebungen, die der mobilen Umgebung ähneln?
Eine dedizierte End-to-End-Sandbox ist zwar nicht verfügbar, wir sind uns jedoch bewusst, dass Entwickler eine produktionsähnliche Testumgebung benötigen. Eine robustere Lösung wird bald angeboten.
Wie kann ich neue Tester hinzufügen?
Ihr Google-Ansprechpartner erstellt für jedes PC-Projekt eine E-Mail-Gruppe, der die Google-Konten der Tester hinzugefügt werden müssen. Nur Mitglieder dieser E‑Mail-Gruppe sind berechtigt, die Testpakete in Google Play Games herunterzuladen.
Sonstiges
Kann ich ein VPN verwenden?
Wenn Sie Ihr Spiel in Regionen testen müssen, in denen Google Play Spiele auf dem PC nicht unterstützt wird, empfehlen wir, ein VPN zu verwenden, um eine IP-Adresse aus einer unterstützten Region zu erhalten.
Achten Sie darauf, dass der TUN-Modus im VPN aktiviert ist. Anleitungen zum Aktivieren des TUN-Modus und zum Konfigurieren der Firewall finden Sie im Betriebshandbuch des VPN-Anbieters.
Nachdem der TUN-Modus aktiviert wurde, installiere Google Play Games auf dem PC und den Emulator zu Testzwecken.
Wie kann ich mit der Entwicklung für Google Play Games auf dem PC in Unity oder im UE-Editor beginnen?
- Aktivieren Sie den Entwicklermodus und fahren Sie mit dem Testen fort.
- Fügen Sie die Dateien
manifest.xmlund.dllhinzu. Weitere Informationen finden Sie im Entwicklerdokument. - Registrieren Sie zu Testzwecken eine GUID für Early-Access-Partner.
Wie verwende ich Registrierungsschlüssel richtig?
Sie sollten Registrierungsschlüssel basierend auf dem Stamm-Hive erstellen. Je nach Zweck und Art der Daten können Sie den Stamm-Hive entweder auf
HKEY_LOCAL_MACHINEoderHKEY_CURRENT_USERfestlegen. Der HiveHKEY_LOCAL_MACHINEwird in den Richtlinien als Beispiel verwendet.Welche Anforderungen gelten für die Überprüfung von PC-Paketen durch Google?
PC-Pakete werden auf Malware gescannt. Anschließend testen die Prüfer nur die Installation des Spiels, den erfolgreichen Start und die Deinstallation.
Ist es notwendig, alle APIs zu integrieren?
Andere APIs sind nicht erforderlich, bieten aber zusätzliche Vorteile.
google::play::billingist für In-App-Käufe und den Verkauf digitaler Inhalte erforderlich.google::play::install_referrerist erforderlich, um Verweisdaten zu erfassen, damit Sie nachvollziehen können, über welche Besucherquellen die meisten Nutzer Ihre App herunterladen.google::play::games::integrityist erforderlich, um Ihre App vor böswilligen Akteuren zu schützen, indem potenziell riskante Geräte und unbekannte Emulatoren erkannt werden.Warum werden einige Spielprozesse beendet, wenn der Google Play Games-Client geschlossen wird, andere aber nicht?
Google hat keine Kontrolle über die Unterprozesse oder Prozesse des laufenden Spiels. Das Verhalten hängt davon ab, ob es sich um ein emuliertes Android-Spiel oder ein PC-Spiel handelt. Emulierte Spiele werden in ihrer eigenen Umgebung installiert. Ihr Verhalten hängt daher weitgehend von der Initialisierung und dem Herunterfahren des Emulators ab.
Sollte ich die Deinstallationsfunktion von Google Play Games oder ein benutzerdefiniertes Deinstallationsprogramm verwenden?
Google empfiehlt, die Deinstallationsfunktion von Google Play Spiele zu verwenden.
Weitere Informationen
Wenn Sie weitere Hilfe benötigen, die in diesen FAQs nicht behandelt wird, wenden Sie sich bitte an google-play-games-pc@google.com.