Pierwszym krokiem w integracji gry z usługami gier Google Play (PGS) jest wdrożenie uwierzytelniania na platformie. Jest to wymagane, aby uzyskać dostęp do wszystkich innych funkcji, takich jak osiągnięcia, tabele wyników i wydarzenia.
Pakiet SDK usług gier Play automatycznie przeprowadza uwierzytelnianie na platformie podczas uruchamiania gry, dlatego musisz zintegrować go z grą i wdrożyć zalecany proces uwierzytelniania. Dzięki temu gra będzie gotowa do wdrożenia i będzie spełniać wytyczne dotyczące wrażeń użytkownika w ramach Google Play Games Level Up.
Pojęcia związane z uwierzytelnianiem
W usługach gier Play w wersji 2 koncepcja „logowania” jest podzielona na 2 odrębne warstwy: uwierzytelnianie na platformie i uwierzytelnianie w grze.
Uwierzytelnianie na platformie
Usługi gier Play zapewniają warstwę zaangażowania na platformie. Zarządza relacją gracza z ekosystemem Gier Google Play za pomocą profilu gracza, aby uzyskać dostęp do funkcji takich jak osiągnięcia, tabele wyników i zadania. Uwierzytelnianie na platformie ma te kluczowe cechy:
- Ciche i automatyczne: uwierzytelnianie odbywa się automatycznie w tle po uruchomieniu gry. Usługi gier Play nie wymagają ręcznego przycisku Zaloguj się.
- Identyfikator gracza: po pomyślnym uwierzytelnieniu na platformie usługi gier Play udostępniają stały identyfikator gracza. Ten identyfikator jest taki sam na różnych urządzeniach w przypadku tej samej gry. Używaj tego identyfikatora głównie do śledzenia funkcji platformy, takich jak postępy w osiągnięciach.
- Rozdzielenie: nie możesz używać usług gier Play jako głównego systemu tożsamości w grze do zarządzania kontem gracza w grze, postępami w grze ani ekwipunkiem. Usługi gier Play służą jako stały identyfikator platformy.
Identyfikator gracza
Identyfikator gracza to identyfikator konta gracza w usługach gier Play. Twoja gra może pobrać identyfikator każdego gracza, który zaloguje się w niej za pomocą uwierzytelniania usług Gier Play. Integracja klienta gry, integracja serwera gry i usługa Cloud Save mogą używać tego identyfikatora do bezpiecznego uzyskiwania dostępu do danych gracza z usług Gier Play.
Identyfikator gracza jest taki sam dla użytkownika, który gra w Twoją grę na wielu urządzeniach. Nie zawsze jest on jednak spójny w różnych grach. Więcej informacji znajdziesz w artykule o nowych identyfikatorach graczy.
Uwierzytelnianie w grze
Zarządzasz kontem w grze, czyli systemem tożsamości, który wiąże postępy gracza, ekwipunek i walutę w grze.
- Tożsamość podstawowa: jako podstawowej metody logowania możesz używać własnego backendu, funkcji Zaloguj się przez Google lub innych dostawców.
- Niezależność: gracze mogą logować się w usługach gier Play (tożsamość na platformie), aby zdobywać osiągnięcia, gdy są zalogowani na określone konto IGA (np. konto gościa lub konkretne konto SiWG).
- Zarządzanie wieloma kontami IGA: usługi gier Play obsługują tylko uwierzytelnianie platformy. Twoja gra zarządza podstawowym uwierzytelnianiem graczy na ich kontach IGA. Oznacza to, że nie musisz zmieniać istniejących procesów przełączania się między kontami IGA. Gdy gracze przełączają konta, pozostają uwierzytelnieni na platformie Gier Play za pomocą usług gier Play, a Ty nadal wysyłasz ich dane związane z osiągnięciami i innymi funkcjami usług gier Play do stałego identyfikatora gracza.
Ciągłość na wielu platformach dzięki funkcji Zaloguj się przez Google
Aby pomóc graczom zachować postępy na Androidzie, iOS i w internecie, użyj funkcji Zaloguj się przez Google jako podstawowej metody uwierzytelniania w grze. Weź pod uwagę te kwestie:
- Przycisk Zaloguj się przez Google: w usługach gier Play w wersji 1 przycisk Google Play często obsługiwał logowanie zarówno na platformie, jak i w grze. W wersji 2 są to osobne procesy. Zaimplementuj standardowy przycisk Zaloguj się przez Google, aby gracze mogli się uwierzytelniać i uzyskiwać dostęp do swojego konta IGA.
- Pakiety SDK do logowania przez Google:
- Zarówno na Androidzie, jak i na iOS używaj standardowych pakietów SDK logowania przez Google, aby uwierzytelniać graczy na ich kontach IGA.
- Używaj Google Open ID jako głównego identyfikatora konta gracza w grze.
- Używaj identyfikatora gracza w usługach gier Play, aby zgłaszać postępy gracza w funkcjach Gier Play, takich jak osiągnięcia.
Zalecana integracja
Aby zintegrować grę z usługami gier Play, wykonaj te zalecane czynności:
Inicjowanie i uwierzytelnianie
Ten krok jest wymagany do zainicjowania i uwierzytelnienia gry:
Zaimplementuj uwierzytelnianie platformy, inicjując pakiet SDK usług gier Play w wersji 2 podczas uruchamiania. Więcej informacji znajdziesz w artykule o uwierzytelnianiu platformy w grach na Androida. Ten krok jest wymagany, aby uzyskać dostęp do funkcji usług gier Play, takich jak osiągnięcia i tabele wyników.
Uwierzytelnianie odbywa się jako cichy proces w tle podczas uruchamiania gry. Dotychczasowi użytkownicy usług gier Play po pomyślnym uwierzytelnieniu zobaczą wiadomość powitalną. Użytkownicy, którzy nie mają profilu usług gier Play, podczas inicjowania pakietu SDK są proszeni o utworzenie profilu.

Tworzenie profilu
Aby korzystać z platformy, gracze muszą mieć profil w usługach gier Play. Niektórzy gracze mogą nie mieć profilu w usługach gier Play, gdy uruchamiają grę. Gracze zostaną poproszeni o utworzenie profilu. Możesz wybrać odpowiednie rozwiązanie dla użytkowników, wybierając jedną z tych opcji:
Automatycznie wyświetlane prośby o utworzenie profilu
Automatycznie wywoływane prośby o utworzenie profilu pojawiają się domyślnie, gdy uruchamiasz grę bez profilu usług gier Play.
Zatrzymywanie automatycznie wywoływanych próśb o utworzenie profilu
Wyłącz prośby o wybranie profilu przy uruchamianiu, konfigurując plik manifestu tak, aby zapobiegać automatycznemu wyświetlaniu próśb. Dzięki temu użytkownicy bez profilu usług gier Play mogą nadal wczytywać grę bez prośby o utworzenie profilu usług gier Play.
Użytkownicy mogą logować się za pomocą dowolnego dostawcy tożsamości, ale warto wyświetlić im prośbę o utworzenie profilu, aby zachęcić ich do uwierzytelniania na platformie Gier Play. Wyświetlaj tę prośbę w razie potrzeby, ale upewnij się, że pojawi się, zanim użytkownicy osiągną znaczące postępy w funkcjach takich jak osiągnięcia i tabele wyników.
Rozważ wyświetlanie prośby o utworzenie profilu w tych zalecanych momentach:
- Po ukończeniu samouczka.
- W momencie nagradzania (np. po wygraniu meczu, zdobyciu rzadkiego przedmiotu lub osiągnięciu kamienia milowego).
- W momencie uruchomienia drugiej sesji.
Więcej informacji znajdziesz w artykułach Zapobieganie automatycznemu tworzeniu profilu (Java) i Zapobieganie automatycznemu tworzeniu profilu (Unity).
Uwierzytelnianie w grze
Po pomyślnym przeprowadzeniu uwierzytelniania na platformie deweloperzy powinni wykonać te czynności, aby umożliwić graczom dostęp do ich kont IGA, w zależności od bieżącego stanu gry:
- Jeśli na urządzeniu jest aktywna sesja gry, zezwól graczowi na jej wznowienie.
- Jeśli nie ma aktywnej sesji gry:
- W przypadku płynnego przywracania, gdy ostatnio odtwarzana gra IGA jest powiązana z identyfikatorem gracza PGS, przejdź do automatycznego przywracania powiązanej gry IGA.
- W przeciwnym razie wyświetl graczowi ekran logowania lub tworzenia konta w aplikacji. Gracze mogą następnie wybrać preferowaną metodę uwierzytelniania, aby utworzyć konto IGA lub zalogować się na istniejące.
zakresów protokołu OAuth
Usługi gier Play korzystają z systemu OAuth, aby umożliwić graczom przyznanie grze dostępu do ich konta. Usługi gier Play mają unikalny zakres dla gier (games-lite) i korzystają z innego zakresu (drive.appdata), jeśli Twoja gra używa funkcji zapisanych gier. Funkcja zapisanych gier
umożliwia dostęp do konta Dysku Google użytkownika, na którym są przechowywane dane gry.
Podczas korzystania z pakietu SDK usług gier Play w wersji 2 możesz poprosić o dodatkowe zakresy OAuth.
Jeśli potrzebujesz dodatkowych zakresów protokołu OAuth, zalecamy wywołanie requestServerSideAccess.
Więcej informacji znajdziesz w artykule o pobieraniu kodu uwierzytelniania serwera lub pobieraniu kodów uwierzytelniania serwera.
Wskazówki dotyczące wrażeń użytkownika w przypadku idealnego procesu uwierzytelniania
Poniższe wskazówki opisują zalecany proces uwierzytelniania w przypadku integracji z PGS v2. Obejmują one scenariusze dla nowych, obecnych i powracających użytkowników oraz tryb gościa.
Nowy gracz
Ten proces dotyczy użytkownika, który po raz pierwszy uruchamia grę na urządzeniu bez wcześniejszej historii rozgrywki.
- Po uruchomieniu pakiet SDK usług gier Play inicjuje uwierzytelnianie tożsamości użytkownika na platformie (identyfikator gracza w usługach gier Play).
- Po tym procesie w tle gra wyświetla graczowi opcje tworzenia konta IGA, na przykład Utwórz nowe konto, Zaloguj się przez Google lub inne metody logowania społecznościowego.
- Gdy gracz utworzy lub wybierze konto IGA, gra powiąże je z wybranym identyfikatorem podstawowym w backendzie.
- Gra wiąże też wybrane konto IGA z identyfikatorem gracza PGS, oznaczając je jako ostatnio używane konto IGA na potrzeby płynnego przywracania.
Gracze z aktywnymi sesjami
Ten scenariusz opisuje graczy, którzy uruchamiają grę na urządzeniu, na którym mają już aktywną sesję. Celem jest zapewnienie bezproblemowego wejścia.
- Gdy gracz uruchamia aplikację, usługi gier Play dyskretnie uwierzytelniają go w tle, podając Ci identyfikator gracza, który umożliwia śledzenie postępów w osiągnięciach i korzystanie z innych funkcji Gier Play.
- Jednocześnie, jeśli ma to zastosowanie, gra pomija ekrany logowania i natychmiast loguje gracza do aktywnej sesji IGA lub ostatnio odtwarzanej sesji IGA powiązanej z jego identyfikatorem gracza, dzięki czemu może on natychmiast wznowić rozgrywkę.
Gracze przełączający konta
Ten proces ma miejsce, gdy gracz z aktywną sesją przechodzi do ustawień gry, aby przełączyć konta. na przykład wylogowanie się z konta głównego, aby użyć konta dodatkowego.
- Gracz wylogowuje się z bieżącej aplikacji IGA, ale połączenie z platformą PGS pozostaje aktywne.
- Gdy gracz zaloguje się za pomocą innego konta IGA, gra powiąże to nowe konto z bieżącym identyfikatorem gracza w usługach gier Play jako ostatnio używane konto IGA tylko na potrzeby płynnego przywracania.
Bezproblemowe przywracanie dla powracających graczy
Ten scenariusz ma zastosowanie, gdy gracz uruchamia grę po okresie nieaktywności, ponownej instalacji lub na zupełnie nowym urządzeniu. Zalecamy, aby w grze zaimplementować płynne przywracanie.
- Po uruchomieniu usługi gier Play uwierzytelniają użytkownika i podają grze identyfikator gracza w usługach gier Play.
- Gra sprawdza swój backend (lub pobrany token Recall, jeśli używa interfejsu Recall API), aby sprawdzić, czy ostatnio używane konto IGA jest już połączone z tym identyfikatorem PGS.
- Jeśli link zostanie znaleziony, gra automatycznie przywróci postępy gracza i zaloguje go, całkowicie pomijając ekran logowania ręcznego.
- W przeciwnym razie gra wyświetla ekran logowania.
- Następnie gracz wybiera metodę logowania i loguje się w IGA.
- Następnie gra wiąże to konto IGA z identyfikatorem gracza w usługach gier Play jako ostatnio używane konto IGA, aby umożliwić bezproblemowe przywracanie.
Tryb gościa
Gracze mogą uruchomić grę i grać, korzystając z lokalnego konta gościa. Usługi gier Play nadal uwierzytelniają gracza w tle. Jeśli gracz wybierze Zapisz postępy, gra przekonwertuje sesję gościa na stałe konto IGA i powiąże je z identyfikatorem gracza. Więcej informacji o rozwiązywaniu konfliktów znajdziesz w artykule Konto gościa.
Testowanie gry
Przetestuj grę, aby upewnić się, że działa zgodnie z oczekiwaniami. Testy, które przeprowadzasz, zależą od funkcji gry.
Oto lista najczęstszych testów, które warto przeprowadzić.
Udało się zalogować.
Logowanie automatyczne działa. Użytkownik powinien być zalogowany w usługach gier Play po uruchomieniu gry.
Wyświetli się wyskakujące okienko powitalne.
Przykładowe wyskakujące okienko powitalne (kliknij, aby powiększyć). Wyświetlą się komunikaty logu o powodzeniu. Uruchom w terminalu to polecenie:
adb logcat | grep com.google.android.
Poniżej znajdziesz przykład komunikatu logu informującego o powodzeniu:
[
$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup. [CONTEXT service_id=1 ]
Zapewnij spójność komponentów interfejsu.
Wyskakujące okienka, tabele wyników i osiągnięcia wyświetlają się prawidłowo i spójnie na różnych rozmiarach i orientacjach ekranu w interfejsie usług gier Play.
Opcja wylogowania nie jest widoczna w interfejsie usług gier Play.
Upewnij się, że możesz pobrać identyfikator gracza i że funkcje po stronie serwera działają zgodnie z oczekiwaniami.
Jeśli gra korzysta z uwierzytelniania po stronie serwera, dokładnie przetestuj proces
requestServerSideAccess. Upewnij się, że serwer otrzymuje kod autoryzacji i może go wymienić na token dostępu. Przetestuj scenariusze powodzenia i niepowodzenia w przypadku błędów sieci oraz nieprawidłowych scenariuszyclient ID.
Jeśli Twoja gra korzystała z którejkolwiek z tych funkcji, przetestuj je, aby upewnić się, że działają tak samo jak przed migracją:
- Tabele wyników: przesyłaj wyniki i wyświetlaj tabele wyników. Sprawdź, czy ranking oraz nazwy graczy i wyniki są wyświetlane prawidłowo.
- Osiągnięcia: odblokuj osiągnięcia i sprawdź, czy są prawidłowo rejestrowane i wyświetlane w interfejsie Gier Play.
- Zapisane gry: jeśli gra korzysta z zapisanych gier, upewnij się, że zapisywanie i wczytywanie postępów w grze działa bez zarzutu. Jest to szczególnie ważne w przypadku testowania na wielu urządzeniach i po aktualizacjach aplikacji.