Migracja z interfejsu API do pakietu SDK

Jeśli Twoje gry natywne w ramach Gier Google Play na PC bezpośrednio wywołują interfejsy Płatności w Play API, musisz przeprowadzić migrację gry, 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ą, jak przeprowadzić migrację gry natywnej do pakietu SDK.

Konfiguracja i przygotowanie

W tej sekcji opisujemy kroki migracji z rozwiązania opartego na interfejsie API do natywnego pakietu SDK Gier Google Play na PC.

Argumenty wiersza poleceń

Natywny pakiet SDK Gier Google Play na PC korzysta z niektórych argumentów wiersza poleceń przekazywanych podczas uruchamiania procesu gry w celu uwierzytelnienia 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 dotyczącym obsługi wielu procesów gry w konfiguracji.

Mapowanie interfejsu API

Aby zakończyć migrację, musisz usunąć wszystkie bezpośrednie wywołania interfejsu API do serwerów Play. W pakiecie SDK znajdują się odpowiednie wywołania funkcji, które zapewniają tę samą funkcjonalność. W tej sekcji znajdziesz mapowanie każdej funkcji.

Logowanie przez Google

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

Rozwiązania oparte na pakiecie SDK używają konta Google klienta Gier Google Play, które jest już powiązane z profileem gracza i uprawnieniami. Zapewnia to graczom płynniejsze działanie, a programistom bezpieczniejsze środowisko, ponieważ pakiet SDK może bezpiecznie komunikować się z klientem Gier Google Play za pomocą IPC.

Zamiast logowania przez Google wywołaj Initialize SDK jak najszybciej. Podejmij odpowiednie działania na podstawie kodu błędu, aby zapewnić bezpieczne środowisko dla czasu działania gry.

Pobieranie listy produktów

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

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

Pobieranie zakupów

W rozwiązaniu opartym na interfejsie API serwer backendu pobiera zakupy użytkownika za pomocą punktu końcowego purchases.products.get interfejsu Play Developer API.

W pakiecie SDK użyj funkcji QueryPurchases bezpośrednio z klienta gry.

Uruchamianie procesu zakupu

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

W pakiecie SDK uruchom proces, wywołując funkcję BillingClient's LaunchPurchaseFlow. Pakiet SDK zajmuje się wszystkimi niezbędnymi czynnościami.

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 oparte na interfejsie API, jak i rozwiązanie oparte na pakiecie SDK zalecają wykonanie tych czynności na serwerze backendu ze względów bezpieczeństwa.

Proces jest podobny w przypadku obu rozwiązań:

Po pobraniu tokena zakupu z zakupu, np. ProductPurchase.purchaseToken w rozwiązaniu opartym na interfejsie API lub ProductPurchaseDetails's purchase_token w rozwiązaniu opartym na pakiecie SDK, wyślij go do backendu w celu weryfikacji.

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

Przesyłanie 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 Windows App Bundle i przesłane w Konsoli Play. Więcej informacji o pakowaniu gry w pakiet aplikacji Windows App Bundle znajdziesz w dokumentacji: