Najczęstsze pytania

W tym dokumencie znajdziesz odpowiedzi na najczęstsze pytania dotyczące pakietów SDK i publikowania w Grach Google Play na PC.

Zarabianie

  1. Dlaczego po dodaniu nowego klucza rozliczeniowego lub licencyjnego proces zakupu kończy się błędem o kodzie 6?

    Nowo wygenerowane klucze licencyjne w Konsoli Google Play są przechowywane w pamięci podręcznej i rozpowszechniane w backendzie handlowym z kilkugodzinnym opóźnieniem, zanim wewnętrzne pamięci podręczne Google Play zostaną zsynchronizowane we wszystkich środowiskach wyświetlania. Mimo że klient gry może pomyślnie wysyłać zapytania o szczegóły produktu, prośby o zakup będą kończyć się niepowodzeniem z kodem błędu 6, dopóki synchronizacja nie zostanie zakończona. Po przesłaniu lub zaktualizowaniu klucza licencyjnego odczekaj kilka godzin, zanim przetestujesz zakupy.

  2. Czy mogę korzystać z procesu zakupu bez serwera backendu?

    Ze względów bezpieczeństwa Google zaleca korzystanie z serwera backendu.

    Więcej informacji znajdziesz w sekcji Przetwarzanie bez serwera backendu.

  3. Czy po zintegrowaniu pakietu SDK Gier Google Play na PC można korzystać z dotychczasowych systemów płatności opartych na interfejsie API?

    Wszystkie płatności muszą być obsługiwane przez pakiet SDK Gier Google Play na PC przy użyciu Płatności w Google Play. Nie możesz używać dotychczasowej formy płatności opartej na interfejsie API w tej samej grze.

  4. Jak możemy wykorzystać zakupy w trybie dewelopera?

    Przyjmij zakup w trybie dewelopera w ciągu 3 minut. W przeciwnym razie środki zostaną zwrócone.

  5. Czy płatności cykliczne lub subskrypcje są obsługiwane?

    Nie w najbliższej przyszłości, ale możesz podać konkretne przypadki użycia, które możemy dodać do naszego planu działania.

  6. Co oznacza błąd płatności w wywołaniach zakupu?

    BillingError to odpowiedź dotycząca wyniku płatności. Funkcja LaunchPurchaseFlow natychmiast zwróci wynik bez blokowania, ale musisz nasłuchiwać wywołania zwrotnego, aby dowiedzieć się, kiedy proces się zakończył, i uzyskać wynik.

  7. Jak mogę korzystać z weryfikacji zakupów po stronie klienta?

    Zalecamy korzystanie z zakupów po stronie serwera i procesu ich weryfikacji. Przetwarzanie zakupów z aplikacji klienckiej wymaga, aby gra znajdowała się na liście dozwolonych. Jeśli Twoja gra wymaga dostępu, skontaktuj się z partnerem Google. Więcej informacji znajdziesz w sekcji Przetwarzanie bez serwera backendu.

  8. Jakie są limity interfejsu API dotyczące wysyłania zapytań o szczegóły produktu?

    Maksymalna liczba produktów, o które można wysłać zapytanie w jednym wywołaniu interfejsu API QueryProductDetails, to 50. Jeśli przekroczysz ten limit, musisz podzielić żądanie na kilka wywołań.

  9. Dlaczego podczas wczytywania wielu kodów SKU produktów zapytania o produkty lub procesy zakupu kończą się błędami wewnętrznymi?

    Wykonywanie zbyt wielu zapytań o SKU produktów naraz lub zbyt częste wywoływanie funkcji QueryProductDetails w C++ lub QueryProductDetailsAsync w Unity w krótkim czasie (np. wysyłanie dziesiątek wywołań zbiorczych w ciasnej pętli lub tworzenie nowej instancji BillingClient na partię) może przeciążyć lokalne połączenia IPC i połączenia z backendem. Gdy te połączenia zostaną zresetowane, zapytania o szczegóły produktu nie będą działać, a gra nie będzie mogła uzyskać tokenów oferty wymaganych do uruchomienia procesu zakupu.

    Aby uniknąć tych błędów podczas wczytywania katalogu, postępuj zgodnie z tymi wskazówkami:

    • Przestrzegaj obsługiwanej liczby produktów na wywołanie: w jednym wywołaniu QueryProductDetails lub QueryProductDetailsAsync wysyłaj zapytanie o maksymalnie 50 produktów i zapisuj zwrócone obiekty ProductDetails w pamięci podręcznej, zamiast wielokrotnie wysyłać zapytania o cały katalog. Więcej informacji o obsługiwanych limitach zbiorczych i zapytaniach o szczegóły produktu znajdziesz w odpowiedzi na poprzednie pytanie dotyczące limitów interfejsu API, w sekcji Wyświetlanie produktów dostępnych do kupienia w przypadku C++ oraz w sekcji Wysyłanie zapytań o szczegóły produktu w przypadku Unity.
    • Unikaj wielokrotnego wywoływania interfejsów API w krótkim czasie: nie wysyłaj wielu zapytań o produkty jednocześnie ani jedno po drugim bez zachowania odstępów. Użyj ponownie pojedynczej instancji BillingClient, serializuj żądania lub ogranicz równoczesność do 2 lub 3 wywołań jednocześnie i dodaj krótkie opóźnienie między kolejnymi partiami.
    • Zaktualizuj pakiet SDK do najnowszej wersji: zaktualizuj integrację do najnowszej wersji pakietu SDK Gier Google Play na PC (26.9.261.0 w przypadku C++ lub 26.9.261.0 w przypadku Unity) pobranej ze strony Pobieranie pakietu SDK Gier Play na PC, aby mieć pewność, że klient zawiera najnowsze ulepszenia dotyczące płatności i stabilności IPC.
  10. Jakie parametry są wymagane podczas wywoływania funkcji Query Purchases lub Launch Purchase Flow w klientach rozliczeniowych?

    Funkcja akceptuje QueryPurchasesContinuation, czyli wywołanie zwrotne funkcji z podpisem std::function<void(QueryPurchasesResult)>. Wywołanie zwrotne przekazuje wynik ze wszystkimi ProductPurchaseDetails. Te informacje są dostępne w plikach nagłówków pakietu SDK w pliku includes/billing/models.h.

    Wynikowy launch_purchase_flow_result ma funkcje ok() i code(). Funkcja ok() zwraca informację o tym, czy przepływ się powiódł. Funkcja code() zwraca typ wyliczeniowy BillingError (includes/billing/enums.h), który ma 10 możliwych przypadków błędów, takich jak anulowanie przez użytkownika lub błąd sieci.

  11. Czy w przypadku procesu zakupu w aplikacji w klientach rozliczeniowych obsługiwana jest niestandardowa kolejność?

    W obecnej wersji pakietu SDK nie można przekazywać własnych danych. Możesz jednak podać dowolną kombinację parametrów obfuscated_account_id i obfuscated_profile_id. Możesz nie podawać żadnego z nich, podać tylko jeden lub oba.

    Pole offer_token jest wymagane i określa ofertę zakupu, którą użytkownik próbuje kupić w procesie płatności. Na razie każdy kod SKU w Google Play ma dokładnie 1 ofertę (np. kup 1 produkt za 10 zł). W przyszłości zespół ds. Płatności w Play zapewni obsługę wielu ofert.

    Aby mieć pewność, że metadane zostaną powiązane w przypadku przerwania procesu zakupu, zapisz je na serwerze backendu przed uruchomieniem okna zakupu i powiąż je z identyfikatorem konta użytkownika, kupowanym SKU i bieżącą sygnaturą czasową. Więcej informacji znajdziesz w artykule Powiązywanie zakupu z danymi wewnętrznymi.

  12. Jakie warunki trzeba spełnić, aby przejść z płatności Google z OAuth na płatności Google oparte na bibliotece DLL?

    Gry mogą nadal używać logowania OAuth przez Google do zarządzania zalogowanym kontem, ale zalecamy zaprzestanie korzystania ze starszych interfejsów API REST do rozliczeń. Przejście z interfejsów API rozliczeń REST (z logowaniem OAuth2) na proces SDK może być operacją z flagą funkcji, więc oba te rozwiązania mogą współistnieć przez pewien czas, gdy gra przechodzi na nowe rozwiązanie.

  13. Czy wywołanie interfejsu API procesu zakupu jest przetwarzane przez przeglądarkę?

    Nie, proces zakupu odbywa się teraz całkowicie w grze za pomocą nakładki WebView, bez opuszczania klienta gry.

  14. Czy użytkownik musi logować się osobno w każdej grze, aby dokonać zakupu?

    Konto na pierwszym planie w Grach Google Play jest używane w każdej sesji gry, więc nie musisz się ponownie logować. Konto, którego używasz w Grach Google Play, gdy rozpoczyna się sesja gry, jest kontem, na którym są wykonywane wywołania interfejsu API. Proces zakupu będzie automatycznie korzystać z tego konta.

  15. Czy gra może jednocześnie obsługiwać pakiet SDK na PC i starsze systemy płatności?

    System płatności działa w ramach modelu podwójnego przepływu w zależności od wersji binarnej gry. Użytkownicy starszych wersji nadal korzystają z dotychczasowego procesu, a użytkownicy nowych wersji przechodzą na płatności oparte na pakiecie SDK. W okresie przejściowym użytkownicy korzystający z obu procesów płatności współistnieją.

Windows App Bundle

  1. Czy podczas przesyłania pakietu WAB za pomocą programu uruchamiającego innej firmy pakiet gry jest wymagany do sprawdzenia?

    Możesz przesłać tylko instalator, nie musisz przesyłać całego pakietu gry. Weryfikator będzie mógł pobrać pakiet gry za pomocą instalatora.

  2. Czy obowiązują jakieś ograniczenia dotyczące rozmiaru pliku WAB?

    W przypadku publikowania instalatora możesz przesłać plik WAB o rozmiarze do 10 GB. W przypadku publikowania zaplanowanego w Google Play maksymalny rozmiar pliku WAB to 200 GB.

  3. Dlaczego po przesłaniu pakietu WAB moja gra się nie instaluje lub nie pojawia?

    Jeśli gra jest wprowadzana bez wcześniejszej wersji na PC („pierwsza wersja WAB”), system może automatycznie umieścić ją w stanie oczekiwania na publikowanie zaplanowane. Dzieje się tak, ponieważ nie ma istniejącego punktu odniesienia do zaktualizowania. Aby w pełni opublikować pakiet WAB i udostępnić grę do instalacji, musisz przejść do Konsoli Google Play i ręcznie wykonać wymagane działanie związane z publikacją (np. kliknąć „Opublikuj zmiany”).

  4. Jak przesłać pakiet WAB do testów wewnętrznych?

    Udostępnij Google konta z listy dozwolonych, abyśmy mogli je włączyć na potrzeby testów wewnętrznych. Gdy Google otrzyma listę, upewni się, że te osoby zostaną uwzględnione w procesie wprowadzania.

  5. Gdzie należy przesłać pakiet WAB?

    Pakiet WAB możesz przesłać w lokalizacji wymienionej w odpowiedzi na pierwsze pytanie. Nie możesz jednak opublikować jej ręcznie. Musisz podać pracownikom Google obsługującym backend dokładny czas UTC (z dokładnością do godziny). Google skonfiguruje harmonogram publikacji i zadba o to, aby aplikacja została opublikowana na czas.

PC SDK

  1. Jakie są różnice między starszym interfejsem API a pakietem SDK Gier Google Play na PC?

    • Starsza wersja interfejsu API oferuje tylko funkcje rozliczeniowe.
    • Pakiet SDK na PC obsługuje Google Desktop Service (GDS) i pełne funkcje PC.
    • Pakiet SDK na PC nie wymaga logowania się przez przeglądarkę za pomocą konta Google.
  2. Czy istnieje alternatywny sposób inicjowania pakietu SDK przez uruchomienie gry bezpośrednio za pomocą programu uruchamiającego grę, bez korzystania z Gier Google Play na PC?

    Gra musi być uruchamiana przez klienta Gier Google Play na PC. Więcej informacji znajdziesz w tym dokumencie dla deweloperów.

  3. Czy pakiet SDK PC obsługuje znaki wielobajtowe w pliku certyfikatu PEM?

    Tak, pakiet SDK obsługuje znaki wielobajtowe na potrzeby certyfikacji.

  4. Jak pakiet SDK obsługuje logowanie się na konto Google w przypadku wielu instancji lub kont?

    Każde uruchomienie gry w Grach Google Play jest traktowane jako „sesja gry”, a z każdą „sesją gry” może być powiązane konto. Mogą być różne. Jeśli więc uruchomisz grę na koncie A, a następnie przełączysz się na konto B i uruchomisz ją ponownie, obie instancje będą działać jednocześnie.

  5. Czy integracja z Play Install Referrer działa z pakietem SDK na PC?

    Pakiet SDK na PC (wersja 25.5.409.0 lub nowsza) obsługuje interfejs Play Install Referrer API. Więcej informacji znajdziesz w artykule Play Install Referrer API.

Program uruchamiający

  1. Jeśli gracz używa programu uruchamiającego innej firmy zamiast klienta Google Play, czy jego konto usług gier Play zostanie automatycznie zsynchronizowane?

    Aby funkcje pakietu SDK działały, gra musi zostać uruchomiona bezpośrednio przez klienta Gier Google Play. Jeśli grę uruchamia inny proces, np. instalator lub aplikacja uruchamiająca, ten proces musi zostać uruchomiony z klienta Gier Google Play. Gra musi przekazywać wszystkie parametry otrzymane od klienta do procesu klienta.

  2. Jak obsłużyć inicjowanie, jeśli Gry Google Play uruchamiają program uruchamiający gry innej firmy?

    Nie musisz integrować pakietu SDK bezpośrednio z programem uruchamiającym. Musisz jednak przekazać wszystkie argumenty wiersza poleceń otrzymane przez program uruchamiający z klienta Gier Google Play bezpośrednio do utworzonego procesu podrzędnego (pliku wykonywalnego gry). Jeśli inicjowanie się nie powiedzie (np. zwróci błąd kActionRequiredShutdownClientProcess), wszystkie procesy, w tym program uruchamiający, muszą zostać zakończone, aby Gry Google Play mogły spróbować automatycznie przywrócić i ponownie uruchomić grę. Więcej informacji znajdziesz w kroku 5 przewodnika po konfiguracji.

  3. Jak mogę zarządzać aktualizacjami i konserwacją gry oraz programu uruchamiającego po ich opublikowaniu?

    Kolejne aktualizacje i konserwację należy przeprowadzać za pomocą programu uruchamiającego. Klient Gier Google Play nie obsługuje funkcji aktualizacji, więc program uruchamiający musi być w stanie aktualizować zarówno grę, jak i sam program.

  4. Jak instalator otrzymuje token sesji GPG na potrzeby autoodtwarzania?

    GPG przekazuje token sesji do instalatora za pomocą argumentu wiersza poleceń --g_session_token=<token>. Aby włączyć tę funkcję, musisz ustawić acceptsCommandLineArguments="true" w play_publishing_config.xml.

    Instalator odpowiada za wyodrębnienie tego tokena i użycie go do uruchomienia gry. Jeśli nie uda się wygenerować tokena, GPG uruchomi instalator bez tokena (rozwiązanie zastępcze).

Inicjowanie

  1. Czy po uruchomieniu gry w aplikacji Gry Google Play dane mojego konta Google zostaną zsynchronizowane?

    Po uruchomieniu gry za pomocą klienta Gier Google Play konto jest automatycznie synchronizowane i nie trzeba ponownie logować się przez Google.

  2. Czy można wielokrotnie używać parametrów inicjowania?

    Jest to możliwe, o ile klient Gier Google Play jest uruchomiony, a dane logowania są prawidłowe. Jednak w scenariuszach takich jak opisany w przewodniku wszystkie procesy uruchomione przez grę muszą zostać zakończone, gdy użytkownik zamknie grę lub gdy gra zostanie zamknięta z powodu błędu inicjowania pakietu SDK, np. kActionRequiredShutdownClientProcess.

  3. Czy można utworzyć skrót, który będzie bezpośrednio otwierać grę?

    Aby otworzyć grę bezpośrednio, możesz użyć tego identyfikatora URI:

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

    Identyfikator URI obsługuje wykrywanie, czy klient Gier Google Play na PC jest otwarty. Jeśli klient nie jest otwarty, klient Gry Google Play otwiera się przed uruchomieniem gry lub programu uruchamiającego. Musisz zarządzać grą lub programem uruchamiającym, aby zapobiec uruchamianiu wielu instancji.

  4. Czy można zweryfikować instalację Gier Google Play na PC bez użycia pakietu SDK?

    Stan instalacji Gier Google Play na PC możesz sprawdzić bez integrowania pakietu SDK, sprawdzając obecność tego klucza rejestru systemu Windows:

    HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

    Obecność tego klucza wskazuje, że na komputerze są zainstalowane usługi gier Google Play (wymagane do uruchamiania gier na PC). Jeśli klucza nie ma, przekieruj użytkownika na stronę instalacji Gier Google Play na PC, aby pobrał i zainstalował klienta.

Testowanie

  1. Czy istnieją środowiska testów otwartych lub zamkniętych podobne do środowiska mobilnego?

    Chociaż nie jest dostępna dedykowana piaskownica do kompleksowego testowania, zdajemy sobie sprawę, że deweloperzy potrzebują środowiska testowego podobnego do produkcyjnego. Wkrótce udostępnimy bardziej niezawodne rozwiązanie.

  2. Jak mogę dodać nowych testerów?

    Osoba kontaktowa w Google tworzy grupę e-mailową dla każdego projektu PC, do której należy dodać konta Google testerów. Tylko członkowie tej grupy e-mailowej mogą pobierać pakiety testowe w Grach Google Play.

Pozostałe postanowienia

  1. Czy mogę używać sieci VPN?

    Deweloperom, którzy chcą przetestować grę w regionach, w których Gry Google Play na PC nie są obsługiwane, zalecamy użycie sieci VPN w celu uzyskania adresu IP z obsługiwanego regionu.

    Upewnij się, że w sieci VPN włączony jest tryb TUN. Wskazówki dotyczące włączania trybu TUN i konfigurowania zapory sieciowej znajdziesz w instrukcji obsługi dostawcy sieci VPN.

    Po włączeniu trybu TUN zainstaluj Gry Google Play na PC i emulator do celów testowych.

  2. Jak zacząć tworzyć gry na PC w edytorze Unity lub UE na potrzeby Gier Google Play?

  3. Jak prawidłowo używać kluczy rejestru?

    Klucze rejestru należy utworzyć na podstawie gałęzi głównej. W zależności od celu i charakteru danych możesz ustawić gałąź główną jako HKEY_LOCAL_MACHINE lub HKEY_CURRENT_USER. W wytycznych jako przykład użyto ula HKEY_LOCAL_MACHINE.

  4. Jakie są wymagania dotyczące sprawdzania pakietów na PC przez Google?

    Pakiety na PC są skanowane pod kątem złośliwego oprogramowania, po czym weryfikatorzy testują tylko instalację gry, jej uruchamianie i odinstalowywanie.

  5. Czy konieczna jest integracja wszystkich interfejsów API?

    Inne interfejsy API nie są wymagane, ale oferują dodatkowe korzyści. google::play::billing jest wymagany w przypadku zakupów w aplikacji i sprzedaży treści cyfrowych. google::play::install_referrer jest wymagany do śledzenia danych o odesłaniach, aby pomóc Ci zrozumieć, które źródła ruchu wysyłają najwięcej użytkowników do pobrania Twojej aplikacji. google::play::games::integrity jest wymagany do ochrony aplikacji przed nieuczciwymi podmiotami przez wykrywanie potencjalnie ryzykownych urządzeń i nieznanych emulatorów.

  6. Dlaczego niektóre procesy gry są przerywane po zamknięciu klienta Gier Google Play, a inne nie?

    Google nie kontroluje podprocesów ani procesów uruchomionej gry. Działanie zależy od tego, czy gra jest emulowaną grą na Androida czy grą na PC. Emulowane gry są instalowane we własnym środowisku, więc ich działanie zależy w dużej mierze od inicjowania i wyłączania emulatora.

  7. Czy mam używać funkcji odinstalowywania Gier Google Play czy niestandardowego deinstalatora?

    Google zaleca korzystanie z funkcji odinstalowywania Gier Google Play.

Dalsza pomoc

Jeśli potrzebujesz dodatkowej pomocy, której nie znajdziesz w tych najczęstszych pytaniach, skontaktuj się z nami pod adresem google-play-games-pc@google.com.