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 migrieren, um das PC SDK zu verwenden.

Je nach verwendeter Game Engine können Sie das C++ SDK oder das C# SDK einbinden. In den Beispiel projekten finden Sie Beispiele, die Sie zum Migrieren Ihres nativen Spiels zum SDK verwenden können.

Einrichtung und Vorbereitung

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

Befehlszeilenargumente

Das native Google Play Games auf dem PC 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 das SDK initialisiert. Wenn Ihr Spielstart mehrere Prozesse umfasst, müssen Sie prüfen, ob alle Argumente an den Prozess übergeben werden, der das SDK letztendlich verwendet. Weitere Informationen finden Sie im Schritt Mehrere Spielprozesse unterstützen der Einrichtung.

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 jede Funktion aufgeführt.

Google-Anmeldung

Die Google-Anmeldung, auch bekannt als Mit Google anmelden, ist eine OAuth-Authentifizierungsmethode, die Nutzern mit einem Google-Konto eine Authentifizierungsoption mit einem Klick bietet. 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 Play Games-Konto des Clients, das bereits mit dem Spielerprofil und den Berechtigungen des Spielers verknüpft ist. Dies bietet Spielern eine nahtlosere Erfahrung und Entwicklern eine sicherere Umgebung, da das SDK über IPC sicher mit dem Google Play Games-Client kommunizieren kann.

Rufen Sie anstelle der Google-Anmeldung so früh wie möglich das SDK auf. Reagieren Sie entsprechend auf den Fehlercode, um eine sichere Umgebung für die Laufzeit Ihres Spiels zu schaffen.

Produktliste abrufen

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

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

Verkäufe erzielen

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

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

Kaufvorgang starten

In der API-Lösung müssen zum Starten des Kaufvorgangs mehrere Endpunkte für die Einrichtung aufgerufen und die erforderlichen Tokens abgerufen werden.

Starten Sie den Vorgang im SDK, indem Sie die Funktion BillingClient's LaunchPurchaseFlow aufrufen. Das SDK erledigt alle erforderlichen Aufgaben.

Kauf verarbeiten

Bei der Verarbeitung des Kaufs eines Nutzers muss der Kauf bestätigt und eingelöst werden, nachdem er erfolgreich als legitim bestätigt wurde. Sowohl die API- als auch die SDK-Lösung empfehlen aus Sicherheitsgründen die Schritte, die im Backend ausgeführt werden müssen.

Der Vorgang ist für beide 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.

Nach der Bestätigung kann Ihr Backend den Kauf sicher bestätigen oder einlösen, nachdem die Berechtigung erteilt wurde.

Zum Testen einreichen

So reichen Sie Ihr Spiel zum Testen ein:

Für die Einreichung verpacken

Spiele, die das SDK verwenden, müssen im Windows App Bundle-Format verpackt und über die Play Console hochgeladen werden. In der Dokumentation finden Sie Informationen zum Verpacken Ihres Spiels im Windows App Bundle-Format für: