Migration von API zu SDK

Wenn Ihre nativen Google Play Games auf dem PC-Spiele die Play Billing APIs direkt aufrufen, müssen Sie Ihr Spiel auf das PC-SDK migrieren.

Je nach verwendeter Game-Engine können Sie das C++ SDK oder das C# SDK einbinden. Beispielprojekte mit Beispielen für die Migration Ihres nativen Spiels zum SDK.

Einrichtung und Vorbereitung

In diesem Abschnitt werden die Migrationsschritte von einer API-basierten Lösung zum Google Play Games auf PC Native SDK beschrieben.

Befehlszeilenargumente

Das Google Play Games auf dem PC Native SDK verwendet einige Befehlszeilenargumente, die beim Start des Spielprozesses übergeben werden, um Nutzer zu authentifizieren. Diese Argumente müssen an den Prozess übergeben werden, der Initialize SDK aufruft. Wenn beim Starten Ihres Spiels mehrere Prozesse beteiligt sind, müssen Sie dafür sorgen, dass alle Argumente an den Prozess übergeben werden, der letztendlich das SDK verwendet. Sehen Sie sich den Schritt Mehrere Spielprozesse unterstützen der Einrichtung an.

API-Zuordnung

Um die Migration abzuschließen, müssen Sie alle direkten API-Aufrufe an die Play-Server entfernen. Im SDK gibt es entsprechende Funktionsaufrufe, um dieselbe Funktionalität zu erreichen. In diesem Abschnitt wird die Zuordnung für die einzelnen Funktionen aufgeführt.

Google-Anmeldung

„Google Log-in“, auch bekannt als Mit Google anmelden, ist eine OAuth-Authentifizierungsmethode, die Nutzern mit ihrem Google-Konto eine Ein-Klick-Authentifizierung ermöglicht. In API-basierten Projekten verknüpfen Sie das Konto eines Spielers mit seinen Käufen. Bei SDK-basierten Lösungen ist diese Verknüpfung nicht erforderlich.

SDK-basierte Lösungen verwenden das Google-Konto des Google Play Spiele-Clients, das bereits mit dem Spielerprofil und den Berechtigungen des Spielers verknüpft ist. Das sorgt für eine reibungslosere Nutzung für Spieler und eine sicherere Umgebung für Entwickler, da das SDK über IPC sicher mit dem Google Play Spiele-Client kommunizieren kann.

Rufen Sie anstelle von Google Sign-in so bald wie möglich Initialize SDK auf. Reagiere entsprechend auf den Fehlercode, um eine sichere Umgebung für die Laufzeit deines Spiels zu schaffen.

Produktliste abrufen

In der API-Lösung ruft Ihr Backend-Server die Produktliste über den Play Developer API-Endpunkt inappproduct.gets ab.

Rufen Sie im SDK die Liste der In-App-Produkte direkt auf dem Client mit der Funktion QueryProductDetails ab.

Verkäufe erzielen

In der API-Lösung ruft Ihr Backend-Server Nutzerkäufe über den Play Developer API-Endpunkt purchases.products.get ab.

Verwenden Sie im SDK die Funktion QueryPurchases direkt von Ihrem Spieleclient aus.

Kaufvorgang starten

In der API-Lösung muss zum Starten des Kaufvorgangs für die Einrichtung und zum Abrufen der erforderlichen Tokens eine Reihe von Endpunkten aufgerufen werden.

Starten Sie den Vorgang im SDK, indem Sie die Funktion LaunchPurchaseFlow von BillingClient aufrufen. Das SDK übernimmt alle erforderlichen Aufgaben.

Kauf verarbeiten

Kauf des Nutzers verarbeiten: Dazu gehört, den Kauf zu bestätigen und zu verbrauchen, nachdem er erfolgreich als legitim validiert wurde. Sowohl bei der API- als auch bei der SDK-Lösung werden die Schritte empfohlen, die aus Sicherheitsgründen in Ihrem Backend ausgeführt werden müssen.

Der Prozess ist für API- und SDK-Lösungen ähnlich:

Nachdem Sie das purchaseToken aus dem Kauf abgerufen haben, z. B. ProductPurchase.purchaseToken in der API-Lösung oder ProductPurchaseDetails's purchase_token in der SDK-Lösung, senden Sie es zur Bestätigung an Ihr Backend.

Sobald die Berechtigung bestätigt wurde, kann dein Backend den Kauf sicher bestätigen oder einlösen.

Zum Testen einreichen

So reichen Sie Ihr Spiel zum Testen ein:

Paket für die Einreichung

Spiele, die das SDK verwenden, müssen im Windows App Bundle-Format verpackt und über die Play Console hochgeladen werden. In der Dokumentation erfahren Sie, wie Sie Ihr Spiel als Windows-App-Bundle verpacken: