Uwierzytelnianie platformy

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.

Prośba o logowanie automatyczne

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.

Prośba o utworzenie profilu po uruchomieniu gry.
Prośba o utworzenie profilu po uruchomieniu gry (kliknij, aby powiększyć).

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:

  1. Jeśli na urządzeniu jest aktywna sesja gry, zezwól graczowi na jej wznowienie.
  2. Jeśli nie ma aktywnej sesji gry:
    1. 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.
    2. 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.

  1. Po uruchomieniu pakiet SDK usług gier Play inicjuje uwierzytelnianie tożsamości użytkownika na platformie (identyfikator gracza w usługach gier Play).
  2. 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.
  3. Gdy gracz utworzy lub wybierze konto IGA, gra powiąże je z wybranym identyfikatorem podstawowym w backendzie.
  4. 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.
New Player with signed in PGS Profile
Nowy gracz z zalogowanym profilem usług gier Play (kliknij, aby powiększyć).
Nowy gracz bez profilu usług gier Play
Nowy gracz bez profilu PGS (kliknij, aby powiększyć).
Nowy gracz z zalogowanym profilem usług gier Play
Nowy gracz z zalogowanym profilem usług gier Play (kliknij, aby powiększyć).

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.

  1. 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.
  2. 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ę.
Uruchom grę na tym samym urządzeniu z zalogowanym profilem PGS.
Uruchom grę na tym samym urządzeniu z zalogowanym profilem usług gier Play (kliknij, aby powiększyć).
Uruchamianie gry na tym samym urządzeniu z wylogowanym profilem PGS
Uruchom grę na tym samym urządzeniu z wylogowanym profilem usług gier Play (kliknij, aby powiększyć).
Uruchom grę na tym samym urządzeniu bez profilu PGS
Uruchom grę na tym samym urządzeniu bez profilu PGS (kliknij, aby powiększyć).
Uruchom grę na nowym urządzeniu z zalogowanym profilem PGS i połączonym kontem IGA.
Uruchom grę na nowym urządzeniu z zalogowanym profilem PGS i połączonym kontem IGA (kliknij, aby powiększyć).
Uruchom grę na nowym urządzeniu z zalogowanym profilem usług gier Play i bez połączonego konta IGA
Uruchom grę na nowym urządzeniu z zalogowanym profilem PGS i bez połączonego konta IGA (kliknij, aby powiększyć).
Uruchom grę na nowym urządzeniu z wylogowanym profilem usług gier Play.
Uruchom grę na nowym urządzeniu z wylogowanym profilem usług gier Play (kliknij, aby powiększyć).
Uruchom grę na nowym urządzeniu bez profilu usług gier Play
Uruchomienie gry na nowym urządzeniu bez profilu PGS (kliknij, aby powiększyć).

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.

  1. Gracz wylogowuje się z bieżącej aplikacji IGA, ale połączenie z platformą PGS pozostaje aktywne.
  2. 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.
Przełącz na konto IGA niepowiązane z żadnym profilem PGS
Przełącz się na konto IGA, które nie jest powiązane z żadnym profilem PGS (kliknij, aby powiększyć).
Przełączanie na aplikację powiązaną z tym samym zalogowanym profilem PGS
Przełącz się na konto IGA powiązane z tym samym zalogowanym profilem PGS (kliknij, aby powiększyć).
Przełączanie na identyfikator IGA powiązany z innym profilem PGS
Przełączanie się na konto IGA powiązane z innym profilem PGS (kliknij, aby powiększyć)
Przełączanie IGA bez profilu usług gier Play na urządzeniu
Przełączanie konta IGA bez profilu PGS na urządzeniu (kliknij, aby powiększyć).
Przełączanie IGA z wylogowanym profilem PGS
Przełączanie IGA z wylogowanym profilem PGS (kliknij, aby powiększyć)
Przełącz na nieistniejący IGA
Przełączanie na nieistniejący adres IGA (kliknij, aby powiększyć)

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.

  1. Po uruchomieniu usługi gier Play uwierzytelniają użytkownika i podają grze identyfikator gracza w usługach gier Play.
  2. 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.
  3. Jeśli link zostanie znaleziony, gra automatycznie przywróci postępy gracza i zaloguje go, całkowicie pomijając ekran logowania ręcznego.
  4. W przeciwnym razie gra wyświetla ekran logowania.
    1. Następnie gracz wybiera metodę logowania i loguje się w IGA.
    2. 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.
Powracający gracz z wylogowanym profilem usług gier Play
Powracający gracz z wylogowanym profilem usług gier Play (kliknij, aby powiększyć).
Powracający gracz z zalogowanym profilem PGS i połączonym kontem IGA
Powracający gracz z zalogowanym profilem PGS i połączonym kontem IGA (kliknij, aby powiększyć).
Powracający gracz z zalogowanym profilem usług gier Play i bez połączonego konta IGA
Powracający gracz z zalogowanym profilem PGS i niepołączonym kontem IGA (kliknij, aby powiększyć).
Powracający gracz bez profilu usług gier Play
Powracający gracz bez profilu PGS (kliknij, aby powiększyć).

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.

Tryb gościa – nie utworzono konta IGA
Tryb gościa – nie utworzono konta IGA (kliknij, aby powiększyć).
Tryb gościa – utworzono IGA
Tryb gościa – utworzono IGA (kliknij, aby powiększyć).

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ć.

  1. Udało się zalogować.

    1. Logowanie automatyczne działa. Użytkownik powinien być zalogowany w usługach gier Play po uruchomieniu gry.

    2. Wyświetli się wyskakujące okienko powitalne.

      Przykładowe wyskakujące okienko powitalne.
      Przykładowe wyskakujące okienko powitalne (kliknij, aby powiększyć).

    3. 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 ]
  2. Zapewnij spójność komponentów interfejsu.

    1. 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.

    2. Opcja wylogowania nie jest widoczna w interfejsie usług gier Play.

    3. Upewnij się, że możesz pobrać identyfikator gracza i że funkcje po stronie serwera działają zgodnie z oczekiwaniami.

    4. 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 scenariuszy client 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.