Po wycofaniu interfejsu Google Sign-In
API w 2026 roku usuniemy pakiet SDK do 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 gier. Zamiast tego zalecamy używanie pakietu SDK do 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 postępuj zgodnie z zaleceniami na liście kontrolnej.
1. Zaloguj się
Poniższa lista kontrolna zawiera zadania związane z wdrażaniem w grze funkcji logowania gracza. 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.2 | Wymagane |
Podczas tworzenia klienta logowania nie wysyłaj prośby o zakresy uprawnień inne niż te związane z Grami Play. Dzięki temu gracze będą mogli automatycznie logować się w Twojej grze, ponieważ żądanie zakresów innych niż Gry Play wymusi na użytkownikach korzystanie z interaktywnego logowania.
Jeśli już prosisz o zakresy inne niż Gry Play, usuń z konstrukcji
// This is the proper way to do it GoogleSignInOptions signInOption = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN; |
1.3 | Wymagane |
Zezwalaj graczom na pozostawanie zalogowanymi.
Po zalogowaniu się gracza w Twojej grze połącz go automatycznie za każdym razem, gdy gra się uruchamia, dopóki gracz nie wyloguje się wyraźnie. |
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 Poniższy przykład pokazuje, jak może wyglądać wyskakujące okienko „Łączenie” w grze na Androida podczas logowania, a następnie krótka animacja logo Usług Google Play Games. ![]() |
1,5 | Wymagane |
Zapewnij graczom możliwość wylogowania się.
Po zalogowaniu się gracz musi mieć zawsze możliwość wylogowania się. Rozważ udostępnienie 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 uruchomi proces logowania (np. kliknie Anuluj w interfejsie logowania), nadal powinien mieć możliwość kontynuowania rozgrywki. Gdy gracz ponownie uruchomi Twoją grę, nie wywołuj automatycznie interaktywnego procesu logowania. Gracze mogą 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ę przed kontynuowaniem rozgrywki. |
1.7 | Sprawdzona metoda |
Maksymalizuj 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):
|
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(-a) 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 dla tego konta istnieją 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 danych w chmurze lub zapisanych gier 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ższe zadania z listy kontrolnej dotyczą wdrażania funkcji Osiągnięcia w Twojej grze.
ID | Ważność | Opis |
---|---|---|
2.1 | Wymagane | Upewnij się, że 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 | Osiągnięcia powinny się od siebie różnić.
Wszystkie obrazy, teksty i opisy powinny być unikalne dla poszczególnych osiągnięć. |
2.3 | Sprawdzona metoda | Osiągnięcia są przyznawane 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 ten zrzut ekranu przedstawia trudne do zdobycia osiągnięcie, które pomaga motywować fanów tytułu i utrzymywać ich zaangażowanie. ![]() |
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ższa lista kontrolna zawiera zadania związane z wdrażaniem w grze funkcji tabel wyników.
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ć.
Jeśli to możliwe, podczas definiowania tablic wyników dodaj limity, 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. Wyników nie należy przesyłać 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ę potwierdzającą, ż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 API tablic wyników 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 kluczowym 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 grałeś(-aś), lub inna lista znajomych.
|
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).
![]() |
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ż 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 na serwerze 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. Jednak identyfikator player_id
zwracany w interfejsie API REST jest zawsze spójny i zawsze jest to identyfikator
widoczny 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ą przechowywane w pamięci podręcznej, dzięki czemu gracze mogą wyświetlać swoje osiągnięcia dowolną liczbę razy bez konieczności wykonywania wielu wywołań usługi. 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 przyrostowe osiągnięć, gdy wykryje, że obowiązuje limit wywołań. |
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 |
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:
|
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:
|
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. |