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ć z grą pakiet SDK PGS w wersji 2 i wdrożyć zalecany proces uwierzytelniania, aby gra była gotowa do wdrożenia i spełniała wytyczne dotyczące wrażeń użytkownika w Google Play Games Level Up.

Pojęcia związane z uwierzytelnianiem

W usługach gier Play w wersji 2 pojęcie „logowania się” jest podzielone 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 ona relacją gracza z ekosystemem Gier Google Play za pomocą profilu gracza, aby umożliwić 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 podczas uruchamiania gry. Usługi gier Play nie wymagają ręcznego kliknięcia przycisku Zaloguj się.
• Identyfikator gracza: po pomyślnym uwierzytelnieniu na platformie usługi gier Play udostępniają stabilny identyfikator gracza. Ten identyfikator jest taki sam na wszystkich urządzeniach w przypadku tej samej gry. Używaj go głównie do śledzenia funkcji platformy, takich jak postępy w zdobywaniu osiągnięć.
• Oddzielenie: nie możesz używać usług gier Play jako głównego systemu tożsamości w grze do zarządzania kontem w grze (IGA) gracza, postępami w grze ani ekwipunkiem. Usługi gier Play służą jako trwały identyfikator platformy.

Identyfikator gracza

Identyfikator gracza to identyfikator konta gracza w usługach gier Play. Twoja gra może pobrać identyfikator gracza dla każdego gracza, który zaloguje się w niej za pomocą uwierzytelniania w usługach gier Play. Integracja klienta gry, integracja serwera gry i usługa zapisywania w chmurze mogą używać tego identyfikatora do bezpiecznego dostępu do danych gracza z usług gier Play.

Identyfikator gracza jest taki sam, gdy użytkownik gra w Twoją grę na wielu urządzeniach. Nie zawsze jednak jest taki sam w różnych grach. Więcej informacji znajdziesz w artykule Identyfikatory graczy nowej generacji.

Uwierzytelnianie w grze

Zarządzasz kontem w grze (IGA), czyli systemem tożsamości, który łączy postępy gracza, ekwipunek i walutę w Twojej grze.

• Podstawowa tożsamość: jako podstawową metodę logowania możesz używać własnego backendu, Zaloguj się przez Google (SiWG) 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 dowolnym koncie IGA (np. na koncie gościa lub na konkretnym koncie logowania się przez Google).
• Zarządzanie wieloma kontami IGA: usługi gier Play obsługują tylko uwierzytelnianie na platformie. Twoja gra zarządza podstawowym uwierzytelnianiem graczy na ich kontach IGA. Oznacza to, że nie trzeba zmieniać dotychczasowych procesów w grze, aby gracze mogli przełączać się między swoimi 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 za pomocą trwałego identyfikatora gracza.

Ciągłość na wielu platformach dzięki logowaniu się przez Google

Aby ułatwić graczom przenoszenie postępów między Androidem, iOS i internetem, używaj logowania się przez Google jako podstawowej metody uwierzytelniania w grze. Pamiętaj o tych kwestiach:

• Przycisk Zaloguj się przez Google: w usługach gier Play w wersji 1 przycisk Google Play często obsługiwał zarówno logowanie się na platformie, jak i w grze. W wersji 2 są to oddzielne procesy. Wdróż standardowy przycisk Zaloguj się przez Google , aby gracze mogli się uwierzytelnić i uzyskać dostęp do swojego konta IGA.
• Pakiety SDK logowania się przez Google:
  • Zarówno w przypadku Androida, jak i iOS używaj standardowych pakietów SDK logowania się przez Google, aby uwierzytelniać graczy na ich kontach IGA.
  • Używaj Google Open ID jako podstawowego 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:

Wdróż uwierzytelnianie na platformie, inicjując pakiet SDK usług gier Play w wersji 2 podczas uruchamiania. Więcej informacji znajdziesz w artykule Uwierzytelnianie na platformie 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 w usługach gier Play, podczas inicjowania pakietu SDK zostaną poproszeni o jego utworzenie.

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 uruchomią Twoją grę. Zostaną poproszeni o jego utworzenie. Możesz zdecydować, jakie wrażenia chcesz zapewnić użytkownikom, wybierając jedną z tych opcji:

Automatycznie wywoływane prośby o utworzenie profilu

Automatycznie wywoływane prośby o utworzenie profilu domyślnie pojawiają się automatycznie, gdy uruchamiasz grę bez profilu w usługach gier Play.

Zatrzymywanie automatycznie wywoływanych próśb o utworzenie profilu

Wyłącz prośby o utworzenie profilu podczas uruchamiania, konfigurując plik manifestu, aby zapobiec automatycznie wywoływanym prośbom. Dzięki temu użytkownicy bez profilu w usługach gier Play mogą nadal wczytywać grę bez konieczności tworzenia profilu w usługach gier Play.

Użytkownicy mogą logować się u dowolnego dostawcy tożsamości, ale powinni zobaczyć prośbę o utworzenie profilu, aby zachęcić ich do uwierzytelnienia się za pomocą uwierzytelniania na platformie Gier Play. Wyświetlaj tę prośbę w razie potrzeby, ale upewnij się, że pojawi się ona, zanim użytkownicy osiągną znaczące postępy w funkcjach takich jak osiągnięcia i tabele wyników.

Rozważ wywołanie prośby o utworzenie profilu w tych zalecanych momentach:

• Po ukończeniu samouczka.
• Podczas momentu z nagrodą (np. wygrania meczu, zebrania rzadkiego przedmiotu lub osiągnięcia kamienia milowego).
• Podczas uruchamiania drugiej sesji.

Więcej informacji znajdziesz w artykułach Zapobieganie automatycznemu wywoływaniu prośby o utworzenie profilu (Java) i Zapobieganie automatycznemu wywoływaniu prośby o utworzenie profilu (Unity).

Uwierzytelnianie w grze

Po pomyślnym uwierzytelnieniu na platformie deweloperzy powinni wykonać te czynności, aby gracze mogli uzyskać dostęp do swoich 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 wznowienie bieżącej sesji.
2. Jeśli nie ma aktywnej sesji gry:
   1. W przypadku bezproblemowego przywracania gdy ostatnio używane konto IGA jest powiązane z identyfikatorem gracza w usługach gier Play, automatycznie przywróć powiązane konto IGA.
   2. W przeciwnym razie wyświetl graczowi ekran logowania lub tworzenia konta w aplikacji. Gracze mogą wtedy wybrać preferowaną metodę uwierzytelniania, aby utworzyć konto IGA lub zalogować się na istniejące.

Zakresy protokołu OAuth

Usługi gier Play korzystają z systemu OAuth , aby umożliwić graczom przyznanie Twojej 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.

Gdy używasz pakietu SDK usług gier Play w wersji 2, możesz poprosić o dodatkowe zakresy protokołu OAuth. Jeśli potrzebujesz dodatkowych zakresów protokołu OAuth, zalecamy wywołanie funkcji requestServerSideAccess. Więcej informacji znajdziesz w artykułach Uzyskiwanie kodu autoryzacji serwera i Pobieranie kodów uwierzytelniania serwera.

Wytyczne dotyczące wrażeń użytkownika w przypadku idealnego procesu uwierzytelniania

Te wytyczne opisują zalecany proces uwierzytelniania w przypadku integracji z usługami gier Play w wersji 2. Obejmują one scenariusze dla nowych, dotychczasowych i powracających użytkowników oraz tryb gościa.

Nowy gracz

Ten proces dotyczy użytkownika, który uruchamia grę po raz pierwszy na urządzeniu, na którym nie ma historii gry.

1. Po uruchomieniu pakiet SDK usług gier Play inicjuje się, aby uwierzytelnić tożsamość użytkownika na platformie (identyfikator gracza w usługach gier Play).
2. Po tym procesie w tle gra wyświetla graczowi opcje utworzenia konta IGA, np. 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 to konto z wybranym podstawowym identyfikatorem w backendzie.
4. Gra powiąże też wybrane konto IGA z identyfikatorem gracza w usługach gier Play, oznaczając je jako ostatnio używane konto IGA, aby umożliwić bezproblemowe przywracanie.

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 do gry.

1. Gdy gracz uruchamia aplikację, usługi gier Play uwierzytelniają się w tle, udostępniając Ci identyfikator gracza, aby śledzić postępy w zdobywaniu osiągnięć i innych funkcji Gier Play.
2. Jednocześnie, w stosownych przypadkach, gra pomija ekrany logowania i natychmiast loguje gracza do aktywnej sesji IGA lub ostatnio używanego konta IGA powiązanego z jego identyfikatorem gracza, aby mógł od razu wznowić rozgrywkę.

Gracze przełączający konta

Ten proces występuje, gdy gracz z aktywną sesją przechodzi do ustawień gry, aby przełączyć konta. Na przykład wylogowuje się z konta głównego, aby użyć konta alternatywnego.

1. Gracz wylogowuje się z bieżącego konta IGA, ale połączenie z platformą usług gier Play pozostaje aktywne.
2. Gdy gracz zaloguje się na inne konto 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 bezproblemowego 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 gra obsługiwała bezproblemowe przywracanie.

1. Po uruchomieniu usługi gier Play uwierzytelniają użytkownika i udostępniają grze identyfikator gracza w usługach gier Play.
2. Gra sprawdza w swoim backendzie (lub pobranym tokenie do pobrania danych, jeśli używasz Recall API), czy ostatnio używane konto IGA jest już połączone z tym identyfikatorem w usługach gier Play.
3. Jeśli znajdzie połączenie, automatycznie przywraca postępy gracza i loguje go, pomijając całkowicie ręczny ekran logowania.
4. W przeciwnym razie gra wyświetla graczowi ekran logowania.
   1. Gracz wybiera metodę logowania i loguje się na konto IGA.
   2. Gra powiązuje to konto IGA z identyfikatorem gracza w usługach gier Play jako ostatnio używane konto IGA na potrzeby bezproblemowego przywracania.

Tryb gościa

Gracze mogą uruchamiać Twoją grę i grać w nią, korzystając z lokalnego konta gościa. Usługi gier Play nadal uwierzytelniają gracza w tle. Jeśli gracz wybierze Zapisz postępy, Twoja gra przekształci sesję gościa w trwałe konto IGA i powiąże je z identyfikatorem gracza. Więcej informacji o rozwiązywaniu konfliktów znajdziesz w artykule Konto gościa.