Migracja z interfejsu API do pakietu SDK

Jeśli Twoje gry natywne w Grach Google Play na PC bezpośrednio wywołują interfejsy API Płatności w Google Play, musisz przenieść grę, aby korzystała z pakietu SDK na PC.

W zależności od używanego silnika gry możesz zintegrować C++ SDK lub C# SDK. Zapoznaj się z przykładowymi projektami, które pokazują przykłady, których można użyć do migracji gry natywnej do pakietu SDK.

Konfiguracja i przygotowanie

W tej sekcji opisujemy proces migracji z rozwiązania opartego na interfejsie API na natywny pakiet SDK do Gier Google Play na PC.

Argumenty wiersza poleceń

Natywny pakiet SDK Gier Google Play na PC korzysta z argumentów wiersza poleceń przekazywanych podczas uruchamiania procesu gry w celu uwierzytelniania użytkowników. Te argumenty muszą zostać przekazane do procesu, który wywołuje Initialize SDK. Jeśli uruchamianie gry obejmuje wiele procesów, musisz sprawdzić, czy wszystkie argumenty są przekazywane do procesu, który ostatecznie korzysta z pakietu SDK. Zapoznaj się z krokiem Obsługa wielu procesów gier w procesie konfiguracji.

Mapowanie interfejsu API

Aby dokończyć migrację, musisz usunąć wszystkie bezpośrednie wywołania interfejsu API na serwery Play. W pakiecie SDK znajdują się odpowiednie wywołania funkcji, które zapewniają te same możliwości. W tej sekcji znajdziesz mapowanie poszczególnych funkcji.

Logowanie przez Google

Logowanie przez Google, znane też jako Zaloguj się przez Google, to metoda uwierzytelniania OAuth, która umożliwia użytkownikom logowanie się jednym kliknięciem za pomocą konta Google. W projektach opartych na interfejsie API konto gracza jest powiązane z jego zakupami. Rozwiązania oparte na pakiecie SDK nie wymagają tego powiązania.

Rozwiązania oparte na pakiecie SDK korzystają z konta Google klienta Gier Google Play, które jest już powiązane z profilem gracza i jego uprawnieniami. Zapewnia to graczom większy komfort, a deweloperom bezpieczniejsze środowisko, ponieważ pakiet SDK może bezpiecznie komunikować się z klientem Gry Play przez IPC.

Zamiast logowania przez Google wywołaj funkcję Initialize SDK jak najwcześniej. Podejmij odpowiednie działania w zależności od kodu błędu, aby zapewnić bezpieczne środowisko działania gry.

Pobieranie listy produktów

W rozwiązaniu API serwer backendu pobiera listę produktów za pomocą punktu końcowego interfejsu Play Developer API inappproduct.gets.

W pakiecie SDK pobierz listę produktów w aplikacji bezpośrednio na urządzeniu klienta za pomocą funkcji QueryProductDetails.

Zwiększ liczbę zakupów

W rozwiązaniu API serwer backendu pobiera zakupy użytkowników za pomocą punktu końcowego purchases.products.get interfejsu Play Developer API.

W pakiecie SDK użyj funkcji QueryPurchases bezpośrednio w kliencie gry.

Uruchamianie procesu zakupu

W rozwiązaniu API uruchomienie procesu zakupu wymaga wywołania wielu punktów końcowych w celu konfiguracji i uzyskania niezbędnych tokenów.

W pakiecie SDK uruchom proces, wywołując funkcję BillingClientLaunchPurchaseFlow. Pakiet SDK wykonuje wszystkie niezbędne czynności.

Przetwarzanie zakupu

Przetwarzanie zakupu użytkownika obejmuje potwierdzenie i wykorzystanie zakupu po pomyślnym sprawdzeniu, czy jest on zgodny z prawem. Zarówno rozwiązanie API, jak i rozwiązanie SDK zalecają wykonanie kroków na backendzie ze względów bezpieczeństwa.

Proces jest podobny w przypadku rozwiązania opartego na interfejsie API i rozwiązania opartego na pakiecie SDK:

Po pobraniu z zakupu elementu purchaseToken, np. ProductPurchase.purchaseToken w rozwiązaniu API lub ProductPurchaseDetails w purchase_token w rozwiązaniu SDK, wyślij go do backendu w celu weryfikacji.

Po weryfikacji backend może bezpiecznie potwierdzić lub wykorzystać zakup po przyznaniu uprawnień.

Prześlij do testowania

Aby przesłać grę do testowania, wykonaj te czynności.

Pakiet do przesłania

Gry korzystające z pakietu SDK muszą być spakowane w formacie pakietu aplikacji na Windowsa i przesłane za pomocą Konsoli Play. Zapoznaj się z dokumentacją, aby spakować grę w pakiet aplikacji dla systemu Windows na potrzeby: