Lista kontrolna jakości usług gier Google Play

Po wycofaniu interfejsu Google Sign-In API w 2026 roku usuniemy pakiet SDK dla gier w wersji 1. Z końcem lutego 2025 r. nie będzie już można publikować w Google Play nowych tytułów, w których zastosowano integrację z wersją 1 pakietu SDK dla gier. Zamiast tego zalecamy używanie pakietu SDK dla gier w wersji 2.
Dotychczasowe tytuły z integracjami gier w wersji 1 będą działać jeszcze przez kilka lat, ale zachęcamy do przejścia na wersję 2 od czerwca 2025 r.
Ten przewodnik dotyczy korzystania z pakietu SDK usług gier Play w wersji 1. Informacje o najnowszej wersji pakietu SDK znajdziesz w dokumentacji wersji 2.

Jakość gry wpływa na jej długoterminowy sukces pod względem liczby instalacji, ocen i opinii graczy, zaangażowania i utrzymania graczy. Przed opublikowaniem gry upewnij się, że spełnia ona podstawowe oczekiwania graczy dzięki atrakcyjnym funkcjom i intuicyjnemu, dobrze zaprojektowanemu interfejsowi.

Ten dokument pomoże Ci skupić się na kluczowych aspektach jakości, zestawu funkcji i interfejsu, które mogą mieć znaczący wpływ na sukces Twojej gry. Każdy obszar jest przedstawiony w formie listy kontrolnej z wymaganiami minimalnymi, sprawdzonymi metodami i przydatnymi ulepszeniami. Aby zapewnić graczom jak najlepszy produkt, w jak największym stopniu stosuj się do zaleceń z listy kontrolnej.

1. Zaloguj się

Poniższa lista kontrolna zawiera zadania związane z wdrażaniem w grze funkcji logowania graczy. Więcej informacji o tym, jak działa logowanie i jak je wdrożyć, znajdziesz w sekcji Koncepcje logowania. Przykłady kodu pokazujące, jak wdrożyć logowanie w grach mobilnych, znajdziesz w artykule Implementowanie logowania na Androidzie.

ID Ważność Opis
1.1 Wymagane Logowanie graczy za pomocą usług gier Google Play
1.1.1. automatycznie logować graczy po uruchomieniu gry; używać logowania ręcznego jako kopii zapasowej;

Gry powinny implementować ciche logowanie, aby gracze mogli szybko uwierzytelniać się i uzyskiwać autoryzację do korzystania z pełnego zestawu funkcji udostępnianych przez usługi gier Google Play. Jeśli logowanie ciche się nie powiedzie, aplikacja powinna poprosić graczy o interaktywne zalogowanie się. Dzięki interaktywnemu logowaniu gracze mogą zalogować się w grze, a Gry Play zadbają o to, aby ich profil był prawidłowo skonfigurowany do używania w Twojej grze. Połączenie cichego i interaktywnego logowania zapewnia najwyższy odsetek logowań przy minimalnych trudnościach dla użytkowników.

Jeśli gracz nie zdecyduje się zalogować, zapamiętaj ten wybór i nie wyświetlaj ponownie monitu. Zamiast tego udostępnij przycisk logowania. Przycisk logowania powinien być łatwy do znalezienia dla graczy. Na przykład powinien być dostępny na ekranie głównym lub w ustawieniach. Ten przycisk nie powinien być ukryty w menu gry na kilku poziomach. Nadal próbuj automatycznie logować graczy za każdym razem, gdy uruchamiają grę. Mogą oni zmienić swoje preferencje i automatycznie się zalogować.

1.2 Wymagane Podczas tworzenia klienta logowania nie proś o zakresy inne niż Gry Play. Dzięki temu gracze będą mogli automatycznie logować się w Twojej grze, ponieważ żądanie zakresów innych niż usługi gier Play wymusi na użytkownikach korzystanie z logowania interaktywnego.

Jeśli już prosisz o zakresy inne niż Gry Play, usuń z konstrukcji GoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptionsGoogleSignInOptions Jeśli musisz poprosić o inne zakresy (np. jeśli chcesz zobaczyć adres e-mail użytkownika w celach marketingowych), zrób to w odpowiednim momencie, a nie w ramach procesu logowania.

// This is the proper way to do it
GoogleSignInOptions signInOption = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN;
1.3 Wymagane Zezwalaj graczom na pozostawanie zalogowanymi.

Gdy gracz zaloguje się w Twojej grze, połącz go automatycznie za każdym razem, gdy gra się uruchomi, dopóki gracz nie wyloguje się.

1,4 Wymagane Wyświetlaj odpowiednio wyskakujące okienko „Łączenie” podczas logowania.

Na urządzeniach z Androidem za każdym razem, gdy wywoływany jest proces logowania, musi się wyświetlać wyskakujące okienko „Łączenie” w Grach Play od Google. Wymaga to wywołania metody setViewForPopups() klasy GamesClient. Sprawdź, czy to wyskakujące okienko jest wyświetlane podczas automatycznego logowania gracza na początku gry. Dzięki temu gracze będą wiedzieć, że logują się do Twojej gry prawidłowo.

Poniższy przykład pokazuje, jak w grze na Androida może wyglądać wyskakujące okienko „Łączenie” podczas logowania, a następnie krótka animacja logo usług Gier Google Play.

Zrzut ekranu przedstawiający wyskakujące okienko „Łączenie z”.
1,5 Wymagane Zapewnij graczom możliwość wylogowania się.

Po zalogowaniu się gracz musi mieć zawsze możliwość wylogowania się.

Rozważ umieszczenie przycisku wylogowania na odpowiednim ekranie gry w aplikacji (np. na ekranie ustawień gracza).

1,6 Sprawdzona metoda Zapamiętywanie, czy gracze odrzucili logowanie.

Jeśli gracz odmówi zalogowania się, gdy gra po raz pierwszy rozpocznie proces logowania (np. kliknie Anuluj w interfejsie logowania), nadal powinien mieć możliwość kontynuowania rozgrywki.

Gdy gracz ponownie uruchomi grę, nie wywołuj automatycznie interaktywnego procesu logowania. Mogą oni zalogować się później, korzystając z przycisku logowania, który powinien znajdować się w systemie ustawień. Dzięki temu gracze nie będą musieli za każdym razem odrzucać logowania, gdy uruchamiają Twoją grę.

Wyjątkiem jest sytuacja, w której gracze próbują uzyskać dostęp do funkcji rozgrywki, która wymaga zalogowania się (np. przesłania wyniku do tabeli wyników). W takim przypadku poproś użytkownika o zalogowanie się, zanim przejdzie dalej.

1.7 Sprawdzona metoda Zwiększ liczbę zalogowanych graczy.

Większa liczba graczy logujących się w Usługach gier Google Play przynosi korzyści Twoim graczom, ponieważ zwiększa możliwości współpracy i rywalizacji w grze. Aby zmaksymalizować liczbę graczy zalogowanych w Usługach Gier Play, zdecydowanie zalecamy automatyczne wyświetlanie graczom prośby o zalogowanie się, jak opisano powyżej.

W przeciwnym razie jak najszybciej przekieruj graczy do procesu logowania z jednego z tych punktów (najpierw zalecane):

  • Natychmiast po rozpoczęciu gry.
  • bezpośrednio po wprowadzeniu, np. po przerywniku filmowym lub samouczku;
  • Gdy gracz kliknie przycisk logowania przez Google w dowolnym miejscu w grze.
1,8 Przydatne Przestrzegaj wskazówek dotyczących marki Google.

Aby zapewnić graczom atrakcyjne i spójne wrażenia, postępuj zgodnie z wytycznymi dotyczącymi marki Usługi gier Google Play.

1.9 Przydatne Przypominaj graczom, że są zalogowani.

Gdy gra wykona w imieniu zalogowanego gracza jakąś czynność, wyświetl mu odpowiednie przypomnienie lub wskazówkę. Jeśli na przykład zalogowany gracz ukończy poziom, możesz wyświetlić komunikat informujący, że jego wynik i osiągnięcia są automatycznie przesyłane: „Jesteś zalogowany w Google. Osiągnięcia i wyniki zostaną zapisane automatycznie.

1.10 Wymagane Twórz kopie zapasowe postępów graczy za pomocą identyfikatora usług gier Play.

Aby gracze nie tracili postępów podczas przełączania lub resetowania urządzeń albo gdy grają na wielu urządzeniach, zadbaj o to, aby ich postępy były zapisywane w chmurze. Jeśli używasz własnego serwera backendu gry, jako klucza używaj identyfikatora usług gier Play i zabezpiecz go. Gdy gracze zalogują się za pomocą identyfikatora usług gier Play, sprawdź, czy na tym koncie są zapisane postępy. Jeśli tak, pozwól graczowi kontynuować grę od miejsca, w którym została przerwana. Możesz użyć własnego rozwiązania do zapisywania w chmurze lub usługi Zapisane gry w usługach gier Play.

Jeśli użytkownik nie jest zalogowany, spróbuj zachować postęp odtwarzacza lokalnie, a następnie zsynchronizować go, gdy użytkownik się zaloguje. Dzięki temu unikniesz utraty postępów gracza, jeśli odłoży on logowanie się do Twojej gry.

2. Osiągnięcia

Poniższa lista kontrolna dotyczy wdrażania funkcji Osiągnięcia w Twojej grze.

ID Ważność Opis
2.1 Wymagane Sprawdź, czy wszystkie osiągnięcia są możliwe do zdobycia.

Gracze muszą mieć możliwość odblokowania wszystkich utworzonych przez Ciebie osiągnięć.

2.2 Sprawdzona metoda Wyróżniaj osiągnięcia.

Wszystkie obrazy, teksty i opisy powinny być unikalne dla poszczególnych osiągnięć.

2.3 Sprawdzona metoda Osiągnięcia są punktowane proporcjonalnie.

Punkty za osiągnięcia powinny być proporcjonalne do czasu lub umiejętności wymaganych do zdobycia danego osiągnięcia.

2.4 Sprawdzona metoda Zaprojektuj osiągnięcia o różnym poziomie trudności.

Dodaj kilka łatwych osiągnięć, które gracz może zdobyć podczas zwykłej rozgrywki, kilka osiągnięć o średnim poziomie trudności, które wymagają większych umiejętności lub zaangażowania, oraz 1–2 bardzo trudne osiągnięcia dla najbardziej oddanych graczy.

Na przykład na tym zrzucie ekranu widać trudne do zdobycia osiągnięcie, które motywuje fanów gry i zachęca ich do dalszego grania.

trudne do zdobycia osiągnięcie, które wymaga zdobycia 5000 klejnotów;
2.5 Przydatne Nie umieszczaj osiągnięć na początku.

Unikaj przyznawania więcej niż 1 osiągnięcia w pierwszych 5 minutach rozgrywki, ponieważ nowi gracze nie będą jeszcze wystarczająco zaangażowani, aby się tym przejmować.

Nie definiuj osiągnięć w taki sposób, aby były przyznawane zbyt wcześnie w trakcie rozgrywki. Uważaj na osiągnięcia, które można łatwo zdobyć na początku gry, np. „Ukończ poziom bez otrzymania obrażeń”.

2.6 Przydatne Zdefiniuj osiągnięcia związane z ciekawymi działaniami w grze.

Wybierz dane, aby tworzyć osiągnięcia, które sprawią, że Twoja gra będzie bardziej atrakcyjna i zachęcająca do ponownego grania (np. „liczba zabitych zombie” jest ciekawszym wskaźnikiem niż „liczba mil, które pokonała Twoja postać”).

2.7 Przydatne Używaj ikon osiągnięć w kolorze.

Usługi gier Google Play używają wersji ikon osiągnięć w odcieniach szarości, aby pokazać, czy zostały one zdobyte. Jeśli możesz używać tylko czarnych (lub tylko białych) ikon osiągnięć, wyświetlaj je na kolorowym tle.

2.8 Przydatne Ograniczaj używanie ukrytych osiągnięć.

Ukryte osiągnięcia powinny być używane tylko po to, aby uniknąć spoilerów w grze. Nie powinny być normą.

2.9 Przydatne Unikaj osiągnięć, które w zbyt dużym stopniu zależą od przypadku.

„Znajdź 100 skrzyń ze skarbami” to lepsze osiągnięcie niż „Znajdź przedmiot, który ma 1% szans na pojawienie się w skrzyni ze skarbami”.

2.10 Przydatne Myśl jak „łowca osiągnięć”.

Niektórzy gracze będą próbowali zdobyć wszystkie utworzone przez Ciebie osiągnięcia. Staraj się udostępniać osiągnięcia, które będą atrakcyjne dla tej kategorii graczy. Unikaj tworzenia osiągnięć, które w zbyt dużym stopniu zależą od elementów poza kontrolą gracza lub których nie można zdobyć po podjęciu przez gracza decyzji w grze.

2.11 Przydatne Sprawdź, czy ikona osiągnięcia wyświetla się prawidłowo.

Gdy ikona osiągnięcia jest wyświetlana w powiadomieniu na urządzeniu z Androidem, jest nałożona na kółko, a jej zewnętrzne rogi są ukryte. Upewnij się, że w takich warunkach ikona nadal dobrze wygląda.

3. Tabele wyników

Poniższe zadania z listy kontrolnej dotyczą wdrażania funkcji tabel wyników w grze.

ID Ważność Opis
3.1 Sprawdzona metoda Wyświetlaj tabele wyników w menu głównym i po kluczowych przejściach.

Tabele wyników powinny być łatwo dostępne po wczytaniu gry. Po ważnych momentach w grze (np. po zakończeniu poziomu lub śmierci gracza) użytkownicy powinni od razu widzieć linki do odpowiednich tablic wyników.

3.2 Sprawdzona metoda Określ górne limity wyników, które można przesłać.

W miarę możliwości dodaj limity podczas definiowania tablic wyników, aby odrzucać oczywiste fałszywe wyniki.

3.3 Sprawdzona metoda Używaj ikon niestandardowych.

Utwórz niestandardową ikonę dla każdej zdefiniowanej tablicy wyników. Nie używaj ikony gry, ponieważ będzie się ona źle wyświetlać w aplikacji Gry Google Play.

3.4 Sprawdzona metoda Zachowaj odpowiednią częstotliwość przesyłania wyników.

Przesyłaj wyniki po ważnych momentach w grze, np. po zakończeniu poziomu lub śmierci postaci gracza. W przypadku gier bez krytycznych przejść (np. typu „endless runner”) kieruj się zdrowym rozsądkiem, określając, jak często przesyłać wyniki. Wyniki nie powinny być przesyłane w sposób ciągły ani co sekundę.

3,5 SAR Przydatne Korzystaj z tagów wyników.

Tagi wyników to dodatkowe dane, które można przesyłać wraz z wynikiem. Możesz na przykład wdrożyć tag wyniku jako flagę, aby potwierdzić, że przesłany przez gracza wynik jest prawidłowy.

Niestandardowe tablice wyników mogą też odczytywać dane z tego tagu. Jeśli tag wyniku zawierałby na przykład identyfikator filmu w YouTube z rozgrywką danego gracza, Twoja gra mogłaby utworzyć link do tego filmu w tablicy wyników.

3.6 Przydatne Kreatywne projektowanie własnego interfejsu tabeli wyników

Jeśli masz odpowiednie zasoby, możesz utworzyć własny widok niestandardowej tablicy wyników na podstawie danych z tablicy wyników społecznościowych. Tablice wyników społeczności zwykle zapewniają większe zaangażowanie niż tablice publiczne. Najpierw sprawdź, czy w rankingu społecznościowym są jakieś wpisy. Jeśli nie, użyj publicznej tablicy wyników.

3.7 Przydatne Pokazuj graczom, jak wypadają na tle konkurencji.

Interfejs Leaderboards API obsługuje wyświetlanie okien wyników (np. miejsca gracza w zakresie +/-10 pozycji). Jeśli tworzysz widok niestandardowy, może to być skuteczny sposób na zwiększenie zaangażowania. Może się ona wyświetlać bezpośrednio po krytycznym momencie w grze (np. po zakończeniu poziomu lub śmierci postaci gracza). Unikaj umieszczania niepotrzebnych kliknięć między graczami a informacjami o ich rankingu.

4. Znajomi

Poniższa lista kontrolna dotyczy wdrażania w grze interfejsów API znajomych.

ID Ważność Opis
4.1 Wymagane Gdy gracze są wyświetlani na liście, obok użytkowników, którzy mają profil w Grach Play, wyświetlaj ikonę Gier Play.

Może to być lista znajomych, lista znajomych, z którymi ostatnio grasz, lub inna lista znajomych.

4.1.1. Ikona Gier Play musi być klikalna.
Jeśli użytkownik naciśnie ikonę, gra powinna wywołać funkcję getCompareProfileIntent() lub getCompareProfileIntentWithAlternativeNameHints() , aby wyświetlić interfejs, w którym użytkownik może porównać swój profil z profilem innego gracza.
4.1.2. Obsługa profili graczy i zaproszeń do znajomych w przypadku dostosowywanych nazw graczy w grze.
Jeśli gracz ustawi inną nazwę w grze (i nie używa nazwy profilu w Grach Play), użyj getCompareProfileIntentWithAlternativeNameHints(), aby podać tę alternatywną nazwę w grze zarówno dla bieżącego gracza, jak i dla gracza, którego profil jest wyświetlany. Będzie to kontekst dla widoku profilu i wszelkich zaproszeń do znajomych wysyłanych z tego profilu. Przekazuj tylko trwałe, globalne nazwy graczy, a nie dowolne treści użytkowników. Ten wymóg oznacza, że zaproszenia do znajomych wysyłane z poziomu gry będą zawierać kontekst dla obu graczy:
  • Odbiorca zobaczy nazwę w grze nadawcy zaproszenia oraz nazwę gry.
  • Podczas wyświetlania prośby o znajomość nadawca nadal będzie widzieć nazwę w grze odbiorcy oraz grę, z której wysłano prośbę.
4.2 Sprawdzona metoda Używaj różnych ikon, aby pokazywać, którzy użytkownicy Gier Play są już znajomymi, a którzy nie są jeszcze znajomymi w Gry Play, ale zalogowali się w Gry Play. Użyj 2 ikon dla użytkowników Gier Play: jednej dla „Znajomych” i jednej dla „Osób, które nie są znajomymi” (lub gdy stan znajomości jest nieznany).
Ikona znajomych
Ikona „Nie znajomi”
4,3 Sprawdzona metoda Wywołuj loadFriends() przy każdym logowaniu i wyświetlaj listę znajomych, aby mieć pewność, że jest ona aktualna. Upewnij się, że gracze widzą zaktualizowaną listę.
4.4 Sprawdzona metoda Jeśli Twoja gra zawiera już znajomych w grze, użyj interfejsów Friends API, aby powiększyć listę znajomych przez dodanie znajomych z Gier Play. Jeśli gracz jest na liście znajomych w grze i jest też Twoim znajomym w Grach Play, wyświetl ikonę „Znajomi”.
4,5 Sprawdzona metoda Jeśli gracz odrzuci prośbę o dostęp do listy znajomych, nie wyświetlaj ponownie okna z prośbą o dostęp, chyba że użytkownik wykona działanie wskazujące, że chce przyznać dostęp (np. naciśnie przycisk „Importuj znajomych z Gier Play”).
4.6 Sprawdzona metoda Jeśli gracz odmówił dostępu do listy znajomych, umożliw mu przyznanie tego dostępu w przyszłości (np. po naciśnięciu przycisku „Importuj znajomych z Gier Play”).
4,7 Sprawdzona metoda Jeśli używasz identyfikatora gracza lub listy znajomych z serwerem backendu, musisz uzyskać dostęp do identyfikatora lub listy w bezpieczny sposób. Dodatkowo w przypadku niektórych starszych gier i graczy identyfikator gracza zwracany przez pakiet SDK Androida może nie być taki sam jak identyfikator, który widzą inni gracze, gdy wyświetlają tego gracza w tej samej grze. Jest to szczególnie istotne w przypadku korzystania z listy znajomych. Wartość player_idzwracana w interfejsie API REST jest jednak zawsze spójna i zawsze jest identyfikatoremplayer_idwidocznym dla innych graczy.

5. Limity i ograniczanie liczby żądań

Poniższe zadania z listy kontrolnej dotyczą zarządzania limitami i ograniczaniem liczby żądań w Twojej grze. Aby dowiedzieć się, jak zarządzać limitem przydziału gry i wykrywać przekroczenie limitu szybkości, przeczytaj artykuł Zarządzanie limitem przydziału i limitem szybkości.

ID Ważność Opis
5.1 Sprawdzona metoda Korzystaj z bibliotek klienta.

Biblioteki klienta na urządzenia mobilne wykorzystują wiele strategii, aby zmniejszyć liczbę wywołań usługi. Na przykład dane dotyczące osiągnięć i tabel wyników są buforowane, dzięki czemu gracze mogą wyświetlać swoje osiągnięcia tak często, jak chcą, bez konieczności wykonywania przez usługę wielu wywołań.

Biblioteka klienta Androida nie wyśle wyniku gracza na serwer, jeśli nie jest on tak dobry jak ostatnio przesłany. Biblioteka Androida automatycznie łączy też częste wywołania zwiększające liczbę osiągnięć, gdy wykryje, że przekraczasz limit.

5.2 Przydatne Łącz częste połączenia z osiągnięciami zdobywanymi stopniowo.

Jeśli tworzysz grę walki i masz osiągnięcie „Zadaj 5000 ciosów”, nie wysyłaj wywołania przyrostu osiągnięcia za każdym razem, gdy ktoś zada cios. Poczekaj do końca rundy, a potem wyślij 1 wywołanie increment(xxx) (gdzie xxx to łączna liczba ciosów zadanych w tej rundzie) lub poczekaj, aż zostanie zadanych 50 ciosów, a potem wyślij 1 wywołanie increment(50).

5.3 Przydatne Kontroluj zużycie.

Zwracaj uwagę na liczbę wywołań usług gier Google Play. Nawet jeśli nie przekroczysz limitów żądań, częste wywołania mogą powodować duży ruch w sieci i szybsze wyczerpywanie się baterii urządzenia. Aby tego uniknąć, możesz zastosować te techniki:

  • Podczas wykonywania zapisanych gier zachowaj częstotliwość raz na kilka minut, a nie przy każdym kliknięciu przycisku.
  • Zanim prześlesz najwyższy wynik, poczekaj, aż gracz skończy grę.
  • Sprawdź dzienny limit przydziału aplikacji, otwierając panel projektu w Google Cloud Platform.

6. Zapisane gry

Poniższa lista kontrolna dotyczy wdrażania w grze funkcji zapisanych gier.

ID Ważność Opis
6.1 Wymagane Dodawanie metadanych, aby zapewnić dodatkowy kontekst dla zapisanych gier.

Podczas zatwierdzania zapisu stanu gry musisz podać co najmniej te metadane:

  • Obraz okładki – zrzut ekranu przedstawiający postępy w grze, który przypomina graczom, gdzie skończyli grę.
  • Opis – krótki opis, który zawiera dodatkowe informacje o zdjęciu na okładce.
  • Sygnatura czasowa – wskazuje, jak długo gracz grał w tę zapisaną grę.
6.2 Wymagane Zezwalaj graczom na wczytywanie zapisanych gier.

Wczytuj odpowiednią zapisaną grę, gdy gracze wybierają ją w aplikacji Gry Play lub w domyślnym interfejsie wyboru zapisanych gier.