Häufig gestellte Fragen

In diesem Dokument werden häufig gestellte Fragen zu SDKs und zur Veröffentlichung für Google Play Games auf dem PC beantwortet.

Monetarisierung

  1. Warum schlägt mein Kaufvorgang mit dem Fehlercode 6 fehl, nachdem ich einen neuen Abrechnungs- oder Lizenzierungsschlüssel hinzugefügt habe?

    Bei neu generierten Lizenzierungsschlüsseln in der Google Play Console kommt es im Commerce-Backend zu einer mehrstündigen Verzögerung beim Caching und bei der Weitergabe, bevor die internen Caches von Google Play in allen Bereitstellungsumgebungen synchronisiert werden. Auch wenn Ihr Spielclient Produktdetails erfolgreich abfragen kann, schlagen Kaufanfragen mit dem Fehlercode 6 fehl, bis die Synchronisierung abgeschlossen ist. Warten Sie nach dem Hochladen oder Aktualisieren Ihres Lizenzierungsschlüssels einige Stunden, bevor Sie Käufe testen.

  2. Kann ich den Kaufvorgang ohne Backend-Server verwenden?

    Aus Sicherheitsgründen empfiehlt Google die Verwendung eines Backend-Servers.

    Weitere Informationen finden Sie unter Verarbeitung ohne Backend-Server.

  3. Sind vorhandene API-basierte Zahlungssysteme nach der Integration des Google Play Games auf dem PC SDK zulässig?

    Alle Zahlungen müssen über das Google Play Games auf dem PC SDK mit Google Play Billing abgewickelt werden. Sie können Ihre vorhandene API-basierte Zahlungsmethode nicht im selben Spiel verwenden.

  4. Wie können wir Käufe im Entwicklermodus nutzen?

    Käufe müssen innerhalb von drei Minuten im Entwicklermodus genutzt werden, andernfalls werden sie erstattet.

  5. Werden wiederkehrende Zahlungen oder Abos unterstützt?

    Nicht in naher Zukunft. Sie können uns jedoch gerne spezifische Anwendungsfälle nennen, die wir in unsere zukünftige Roadmap aufnehmen sollen.

  6. Was ist der Abrechnungsfehler in meinen Kaufaufrufen?

    `BillingError` ist die Antwort auf das Zahlungsergebnis. `LaunchPurchaseFlow` wird sofort zurückgegeben, ohne zu blockieren. Sie müssen jedoch auf den Callback hören, um zu erfahren, wann er abgeschlossen ist, und um das Ergebnis zu erfassen.

  7. Wie kann ich die clientseitige Bestätigung von Käufen verwenden?

    Wir empfehlen die serverseitige Kaufabwicklung und den entsprechenden Bestätigungsprozess. Für die Verarbeitung von Käufen über Ihre Client-App muss Ihr Spiel auf einer Zulassungsliste stehen. Wenden Sie sich an Ihren Google-Partner, wenn Ihr Spiel Zugriff benötigt. Weitere Informationen finden Sie unter Verarbeitung ohne Backend-Server.

  8. Welche API-Limits gelten für die Abfrage von Produktdetails?

    Die maximale Anzahl von Produkten, die in einem einzelnen Aufruf der QueryProductDetails API abgefragt werden können, beträgt 50. Wenn Sie dieses Limit überschreiten, müssen Sie die Anfrage in mehrere Aufrufe aufteilen.

  9. Welche Parameter sind erforderlich, wenn ich im Billing Client „Query Purchases“ oder „Launch Purchase Flow“ aufrufe?

    Die Funktion akzeptiert QueryPurchasesContinuation, einen Funktions Callback mit der std::function<void(QueryPurchasesResult)> Signatur. Der Callback übergibt das Ergebnis mit allen ProductPurchaseDetails an Sie. Diese Informationen sind in den SDK-Headerdateien in der Datei includes/billing/models.h verfügbar.

    Das resultierende launch_purchase_flow_result hat die Funktionen ok() und code(). Die Funktion ok() gibt an, ob der Ablauf erfolgreich war. Die Funktion code() gibt die BillingError-Enumeration (includes/billing/enums.h) zurück, die zehn mögliche Fehlerfälle enthält, z. B. „Nutzer hat abgebrochen“ oder „Netzwerkfehler“.

  10. Wird eine benutzerdefinierte Reihenfolge für den Kaufvorgang im Billing Client unterstützt?

    Im aktuellen SDK-Design ist es nicht möglich, eine eigene Nutzlast zu übergeben. Sie können jedoch eine beliebige Kombination aus obfuscated_account_id und obfuscated_profile_id angeben. Sie können keine, nur eine oder beide angeben.

    Das Feld offer_token ist 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. ein Artikel für 10 $). In Zukunft wird das Google Play Billing-Team Unterstützung für mehrere Angebote bereitstellen.

    Damit Metadaten bei Unterbrechungen des Kaufvorgangs zugeordnet werden können, speichern Sie die Metadaten auf Ihrem Backend-Server, bevor Sie den Kaufdialog starten, 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.

  11. Welche Voraussetzungen müssen erfüllt sein, um von der Google-Abrechnung mit OAuth zur DLL-basierten Google-Abrechnung zu wechseln?

    Spiele können weiterhin die OAuth-Anmeldung mit Google verwenden, um das angemeldete Konto zu verwalten. Google empfiehlt jedoch, die älteren REST-Abrechnungs-APIs nicht mehr zu verwenden. Der Wechsel von den REST-Abrechnungs-APIs (mit OAuth2-Anmeldung) zum SDK-Ablauf kann ein Feature-Flag-Vorgang sein, sodass beide für eine gewisse Zeit parallel existieren können, während das Spiel umgestellt wird.

  12. Wird der API-Aufruf „Launch Purchase Flow“ über einen Webbrowser verarbeitet?

    Nein, der Kaufvorgang wird jetzt vollständig im Spiel über eine nahtlose WebView-Überlagerung abgeschlossen, ohne dass der Spielclient verlassen werden muss.

  13. 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 Sie sich nicht noch einmal anmelden müssen. Das Konto, das Sie in Google Play Games verwenden, wenn die Spielsitzung beginnt, ist das Konto, mit dem API-Aufrufe ausgegeben werden. Der Kaufvorgang verwendet dieses Konto automatisch.

  14. Kann ein Spiel gleichzeitig das PC SDK und ältere Zahlungssysteme unterstützen?

    Das Zahlungssystem arbeitet je nach Version der Spieldatei mit einem Dual-Flow-Modell. Nutzer mit älteren Builds verwenden weiterhin den vorhandenen Ablauf, während Nutzer mit neuen Builds zu SDK-basierten Zahlungen wechseln. Nutzer mit beiden Zahlungsabläufen existieren während des Übergangszeitraums parallel.

Windows-App-Bundle

  1. Muss das Spielpaket zur Überprüfung eingereicht werden, wenn ein WAB mit einem Drittanbieter-Launcher eingereicht wird?

    Sie können einfach Ihr Installationsprogramm einreichen. Sie müssen nicht das gesamte Spielpaket einreichen. Der Prüfer kann Ihr Spielpaket mit dem Installationsprogramm herunterladen.

  2. Gibt es Einschränkungen hinsichtlich der Dateigröße von WABs?

    Sie können eine WAB-Datei mit einer Größe von bis zu 10 GB hochladen.

  3. Warum wird mein Spiel nach dem Hochladen meines WAB nicht installiert oder angezeigt?

    Wenn Ihr Spiel ohne eine bereits vorhandene PC-Version eingebunden wird (ein „erstmaliges WAB“), wird es möglicherweise automatisch in den Status „Verwaltung der Veröffentlichung“ versetzt. Das liegt daran, dass es keine vorhandene Baseline gibt, die aktualisiert werden kann. Um das WAB vollständig zu veröffentlichen und das Spiel zur Installation verfügbar zu machen, müssen Sie zur Google Play Console gehen und die erforderliche Veröffentlichungsaktion manuell ausführen (z. B. auf „Änderungen veröffentlichen“ klicken).

  4. Wie lade ich das WAB für interne Tests hoch?

    Geben Sie die Konten auf der Zulassungsliste an Google weiter, damit Google sie für interne Tests aktivieren kann. Sobald Google die Liste hat, sorgt Google dafür, dass sie in den Onboarding-Prozess aufgenommen werden.

  5. Wo sollte das WAB-Paket hochgeladen werden?

    Sie können das WAB-Paket an dem Ort hochladen, der in der ersten Frage erwähnt wird. Sie können es 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

  1. Was sind die Unterschiede zwischen der älteren API und dem Google Play Games auf dem PC SDK?

    • Die ältere API bietet nur Abrechnungsfunktionen.
    • Das PC SDK unterstützt den Google Desktop Service (GDS) und alle PC-Funktionen.
    • Mit dem PC SDK ist keine browserbasierte Google-Anmeldung erforderlich.

  2. Gibt es eine alternative Möglichkeit, das SDK zu initialisieren, indem das Spiel direkt über den Spiel-Launcher gestartet wird, ohne Google Play Games 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.

  3. Unterstützt das PC SDK Multibyte-Zeichen in der PEM-Zertifizierungsdatei?

    Ja, das SDK unterstützt Multibyte-Zeichen für die Zertifizierung.

  4. Wie verarbeitet das SDK die Google-Kontoanmeldung für mehrere Instanzen oder Konten?

    Jeder Spielstart in Google Play Games wird als „Spielsitzung“ behandelt und jeder „Spielsitzung“ kann ein Konto zugeordnet sein. Diese können unterschiedlich sein. Wenn Sie das Spiel also mit Konto A starten und dann zu Konto B wechseln und das Spiel neu starten, können beide gleichzeitig ausgeführt werden.

  5. Funktioniert die Play Install Referrer-Integration mit dem PC SDK?

    Das PC SDK (Version 25.5.409.0 und höher) unterstützt die Play Install Referrer API. Weitere Informationen finden Sie unter Play Install Referrer API.

Launcher

  1. 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 das Spiel von einem anderen Prozess wie einem Installationsprogramm oder einer Launcher-Anwendung gestartet wird, muss dieser Prozess selbst über den Google Play Games-Client gestartet werden. Das Spiel muss alle vom Client empfangenen Parameter an den Clientprozess übergeben.

  2. Wie verarbeite ich die Initialisierung, wenn Google Play Games einen Drittanbieter-Spiel-Launcher startet?

    Sie müssen das SDK nicht direkt in Ihren Launcher einbinden. Sie müssen jedoch alle Befehlszeilenargumente, die der Launcher vom Google Play Games-Client empfängt, direkt an den erstellten untergeordneten Prozess (die ausführbare Datei des Spiels) übergeben. Wenn die Initialisierung fehlschlägt (z. B. durch Zurückgeben 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 in Schritt 5 des Einrichtungsleitfadens.

  3. Wie kann ich Updates und Wartungsarbeiten an meinem Spiel und Launcher durchführen, nachdem sie in der Produktion sind?

    Nachfolgende Updates und Wartungsarbeiten müssen über Ihren Launcher implementiert werden. Der Google Play Games-Client unterstützt keine Update-Funktionen. Daher muss der Launcher sowohl das Spiel als auch sich selbst aktualisieren können.

  4. Wie erhält das Installationsprogramm das GPG-Sitzungstoken für die automatische Wiedergabe?

    GPG übergibt das Sitzungstoken mit dem --g_session_token=<token> Befehlszeilenargument an das Installationsprogramm. Dazu müssen Sie in Ihrer play_publishing_config.xml die Option acceptsCommandLineArguments="true" festlegen.

    Das Installationsprogramm ist dafür verantwortlich, dieses Token zu extrahieren und damit das Spiel zu starten. Wenn die Tokengenerierung fehlschlägt, startet GPG das Installationsprogramm ohne Token (Fallback).

Initialisierung

  1. Wenn ich ein Spiel mit der Google Play Games App starte, werden dann meine Google-Kontodetails synchronisiert?

    Nach dem Start des Spiels über den Google Play Games-Client wird das Konto automatisch synchronisiert und Sie müssen sich nicht noch einmal über den Google-Anmeldeprozess anmelden.

  2. Ist es möglich, die Initialisierungsparameter mehrmals zu verwenden?

    Das ist möglich, solange der Google Play Games-Client ausgeführt wird und die Anmeldeinformationen 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 beendet wird, z. B. kActionRequiredShutdownClientProcess.

  3. Gibt es eine Möglichkeit, eine Verknüpfung zu erstellen, um das Spiel direkt zu öffnen?

    Sie können die folgende URI verwenden, um das Spiel direkt zu öffnen:

    googleplaygames://launch/?pid=2&id=com.company.gamename

    Die URI kann erkennen, ob der Google Play Games auf dem PC-Client geöffnet ist. Wenn der Client nicht geöffnet ist, wird der Google Play Games-Client 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.

  4. Gibt es eine Möglichkeit, die Google Play Games auf dem PC-Installation zu bestätigen, ohne das SDK zu verwenden?

    Sie können den Installationsstatus von Google Play Games auf dem PC bestätigen, ohne das SDK einzubinden. Prüfen Sie dazu, ob der folgende Windows-Registrierungsschlüssel vorhanden ist:

    HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

    Das Vorhandensein dieses Schlüssels zeigt an, dass die Google Play Games-Dienste (die zum Ausführen von Spielen auf dem PC erforderlich sind) auf dem Computer installiert sind. Wenn der Schlüssel fehlt, sollten Sie den Nutzer zur Installationsseite von Google Play Games auf dem PC weiterleiten, damit er den Client herunterladen und installieren kann.

Test

  1. Gibt es offene oder geschlossene Testumgebungen, die denen für Mobilgeräte ähneln?

    Eine spezielle End-to-End-Sandbox ist zwar nicht verfügbar, aber wir wissen, dass Entwickler eine produktionsähnliche Testumgebung benötigen. Bald wird eine robustere Lösung angeboten.

  2. 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

  1. Kann ich ein VPN verwenden?

    Entwicklern, die ihr Spiel in Regionen testen müssen, in denen Google Play Games 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 Sie den TUN-Modus für das VPN aktivieren. Eine Anleitung zum Aktivieren des TUN-Modus und zum Konfigurieren der Firewall finden Sie im Betriebshandbuch des VPN-Anbieters.

    Nachdem der TUN-Modus aktiviert wurde, installieren Sie Google Play Games auf dem PC und den Emulator zu Testzwecken.

  2. Wie kann ich mit der Entwicklung für Google Play Games auf dem PC in Unity oder UE Editor beginnen?

  3. Wie verwende ich Registrierungsschlüssel richtig?

    Sie sollten Registrierungsschlüssel basierend auf der Stammstruktur erstellen. Je nach Zweck und Art der Daten können Sie die Stammstruktur entweder auf HKEY_LOCAL_MACHINE oder HKEY_CURRENT_USER festlegen. In den Richtlinien wird HKEY_LOCAL_MACHINE als Beispiel verwendet.

  4. 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, den erfolgreichen Start und die Deinstallation des Spiels.

  5. Müssen alle APIs eingebunden werden?

    Andere APIs sind nicht erforderlich, bieten aber zusätzliche Vorteile. google::play::billing ist für In-App-Käufe und den Verkauf digitaler Inhalte erforderlich. google::play::install_referrer ist erforderlich, um Verweisdaten zu erfassen und so zu ermitteln, über welche Traffic-Quellen die meisten Nutzer Ihre App herunterladen. google::play::games::integrity ist erforderlich, um Ihre App vor böswilligen Akteuren zu schützen, indem potenziell riskante Geräte und unbekannte Emulatoren erkannt werden.

  6. Warum werden einige Spielprozesse beendet, wenn der Google Play Games-Client geschlossen wird, andere jedoch nicht?

    Google hat keine Kontrolle über die Unterprozesse oder Prozesse des ausgeführten Spiels. Das Verhalten hängt davon ab, ob es sich um ein emuliertes Android-Spiel oder ein PC-Spiel handelt. Emulierte Spiele werden in einer eigenen Umgebung installiert. Ihr Verhalten hängt daher weitgehend von der Initialisierung und dem Herunterfahren des Emulators ab.

  7. Sollte ich die Deinstallationsfunktion von Google Play Games oder ein benutzerdefiniertes Deinstallationsprogramm verwenden?

    Google empfiehlt die Verwendung der Deinstallationsfunktion von Google Play Games.

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.