Uwierzytelnianie platformy

Pierwszym krokiem w integracji gry z usługami gier Google Play jest wdrożenie uwierzytelniania platformy. 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, więc musisz zintegrować pakiet SDK usług gier Play w wersji 2 z grą 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 ramach programu Google Play Games Level Up.

Pojęcia związane z uwierzytelnianiem

W usługach Gier Play w wersji 2 koncepcja „logowania się” jest podzielona na 2 odrębne warstwy: uwierzytelnianie na platformie i uwierzytelnianie w grze.

Uwierzytelnianie platformy

Usługi gier Play zapewniają warstwę zaangażowania na platformie. Zarządza relacją gracza z ekosystemem Gier Google Play za pomocą profilu gracza, aby umożliwić dostęp do funkcji takich jak osiągnięcia, tablice wyników i misje. Uwierzytelnianie platformy ma te kluczowe cechy:

• Ciche i automatyczne: uwierzytelnianie odbywa się automatycznie w tle podczas uruchamiania 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ą stabilny identyfikator gracza. Ten identyfikator jest spójny na wszystkich urządzeniach w przypadku tej samej gry. Używaj tego identyfikatora głównie do śledzenia funkcji platformy, takich jak postępy w zdobywaniu osiągnięć.
• Odłączone: 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), postępami w grze ani ekwipunkiem gracza. 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, który loguje 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 uzyskiwania dostępu do danych gracza z usług Gier Play.

Identyfikator gracza jest spójny dla użytkownika, gdy gra w Twoją grę na wielu urządzeniach. Nie zawsze jest to jednak spójne w przypadku różnych gier. Więcej informacji znajdziesz w artykule o identyfikatorach graczy nowej generacji.

Uwierzytelnianie w grze

Zarządzasz kontem w grze, czyli systemem tożsamości, który wiąże postępy gracza, asortyment i walutę w Twojej grze.

• Tożsamość podstawowa: 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ść platformy), aby zdobywać osiągnięcia, gdy są zalogowani w dowolnej konkretnej usłudze IGA (np. na koncie gościa lub na konkretnym koncie SiWG).
• Zarządzanie wieloma identyfikatorami IGA: usługi gier Play obsługują tylko uwierzytelnianie na platformie. Twoja gra zarządza podstawowym uwierzytelnianiem graczy w ich IGA. Oznacza to, że nie ma żadnych zmian w dotychczasowych procesach przełączania się graczy między 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 na podstawie trwałego identyfikatora gracza.

Spójność na wielu platformach dzięki funkcji Zaloguj się z Google

Aby umożliwić graczom przenoszenie postępów między Androidem, iOS i internetem, używaj logowania za pomocą Google jako podstawowej metody uwierzytelniania w grze. Weź pod uwagę te kwestie:

• Przycisk Zaloguj się przez Google: w PGS 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. Wdróż standardowy przycisk Zaloguj się przez Google, aby umożliwić graczom uwierzytelnianie i uzyskiwanie dostępu do ich IGA.
• Pakiety SDK do logowania się przez Google:
  • Zarówno w przypadku Androida, jak i iOS używaj standardowych pakietów SDK do logowania się w Google, aby uwierzytelniać graczy w ich 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

Aby zainicjować grę i ją uwierzytelnić, wykonaj te czynności:

Wdróż uwierzytelnianie na platformie, inicjując pakiet SDK usług Gier Play w wersji 2 podczas uruchamiania. Więcej informacji znajdziesz w artykule Uwierzytelnianie platformy w przypadku gier 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ę 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 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 zaczną grać w Twoją grę. Ci gracze zostaną poproszeni o utworzenie takiego konta. Możesz wybrać odpowiednie rozwiązanie dla użytkowników, korzystając z jednej z tych opcji:

Automatyczne wyświetlanie próśb o utworzenie profilu

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

Zatrzymywanie automatycznie wywoływanych promptów do tworzenia profilu

Wyłączanie monitów o profil przy uruchamianiu przez skonfigurowanie pliku manifestu, aby zapobiec automatycznemu wywoływaniu monitów. Dzięki temu użytkownicy bez profilu usług gier Play mogą nadal wczytywać grę bez konieczności tworzenia profilu usług gier Play.

Użytkownicy mogą logować się za pomocą dowolnego dostawcy tożsamości, ale warto wyświetlać im prośbę o utworzenie profilu, aby zachęcić ich do uwierzytelniania się za pomocą platformy Gier Play. Wyświetlaj ten prompt w razie potrzeby, ale upewnij się, że pojawia się on, zanim użytkownicy osiągną znaczący postęp w funkcjach takich jak osiągnięcia i tabele wyników.

Rozważ wyświetlanie prompta dotyczącego profilu w tych zalecanych momentach:

• Po ukończeniu samouczka.
• W momencie przyznania nagrody (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 platformy deweloperzy powinni wykonać te czynności, aby umożliwić graczom dostęp do elementów IGA, w zależności od bieżącego stanu gry:

1. Jeśli na urządzeniu istnieje aktywna sesja gry, zezwól graczowi na wznowienie bieżącej sesji.
2. Jeśli nie ma aktywnej sesji gry:
   1. W przypadku płynnego przywracania, gdy ostatnia gra IGA jest powiązana z identyfikatorem odtwarzacza PGS, automatycznie przywróć powiązaną grę 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ć istniejący IGA lub się do niego zalogować.

Zakresy protokołu OAuth

Usługi gier Play korzystają z systemu OAuth, aby umożliwić graczom przyznanie Twojej grze dostępu do ich kont. 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 OAuth. Jeśli potrzebujesz dodatkowych zakresów protokołu OAuth, zalecamy wywołanie funkcji requestServerSideAccess. Więcej informacji znajdziesz w sekcji pobieranie kodu autoryzacji serwera lub pobieranie kodów autoryzacji serwera.

Wskazówki dotyczące wrażeń użytkownika w przypadku idealnego procesu uwierzytelniania

Poniższe wytyczne opisują zalecany proces uwierzytelniania w przypadku integracji z PGS w wersji 2. 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 uruchamia grę po raz pierwszy na urządzeniu, na którym nie grał wcześniej.

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 wstępnym uzgodnieniu gra wyświetla graczowi opcje utworzenia IGA, np. Utwórz nowe konto, Zaloguj się przez Google lub inne metody logowania społecznościowego.
3. Gdy gracz utworzy lub wybierze IGA, gra powiąże to konto z wybranym identyfikatorem podstawowym w swoim backendzie.
4. Gra wiąże też wybraną IGA z identyfikatorem gracza w Usługach gier Play, oznaczając ją jako ostatnią IGA używaną do bezproblemowego przywracania.

Gracze z aktywnymi sesjami

Ten scenariusz opisuje sytuację, w której gracze uruchamiają grę na urządzeniu, na którym mają już aktywną sesję. Celem jest zapewnienie płynnego wejścia.

1. Gdy gracz uruchomi aplikację, usługi gier Play w tle przeprowadzą cichą autoryzację, która zapewni Ci identyfikator gracza umożliwiający śledzenie postępów w zdobywaniu osiągnięć i korzystaniu z innych funkcji gier Play.
2. W odpowiednich przypadkach gra pomija ekrany logowania i natychmiast loguje gracza do aktywnej sesji IGA lub ostatniej sesji IGA powiązanej z jego identyfikatorem gracza, dzięki czemu może on od razu 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.

1. Gracz wylogowuje się z bieżącej IGA, ale połączenie z platformą PGS pozostaje aktywne.
2. Gdy gracz zaloguje się za pomocą innego identyfikatora IGA, gra powiąże to nowe konto z bieżącym identyfikatorem gracza w usługach gier Play jako ostatnio używany identyfikator IGA tylko na potrzeby bezproblemowego przywracania.

Płynne 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 implementowała bezproblemowe przywracanie.

1. Po uruchomieniu usługi gier Play uwierzytelniają użytkownika i przekazują do gry identyfikator gracza w usługach gier Play.
2. Gra sprawdza swój backend (lub pobrany token do pobrania danych, jeśli używa interfejsu Recall API), aby sprawdzić, czy ostatnio używana tożsamość IGA jest już połączona z tym identyfikatorem usług gier Play.
3. Jeśli link zostanie znaleziony, gra automatycznie przywróci postępy gracza i zaloguje go, pomijając ekran logowania ręcznego.
4. W przeciwnym razie gra wyświetli ekran logowania.
   1. Gracz wybiera metodę logowania i loguje się w IGA.
   2. Gra powiąże następnie ten identyfikator IGA z identyfikatorem gracza w usługach gier Play jako ostatni używany identyfikator 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 przekształci sesję gościa w stały identyfikator IGA i powiąże go z identyfikatorem gracza. Więcej informacji o rozwiązywaniu konfliktów znajdziesz w artykule Konto gościa.