Pierwszym krokiem w integracji gry z usługami gier Google Play 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, 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 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 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, 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.
- Podstawowa tożsamość: jako podstawową metodę logowania możesz używać własnego backendu, logowania przez Google 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 usłudze tożsamości w grach (np. na koncie gościa lub na koncie SiWG).
- Zarządzanie wieloma identyfikatorami gracza: 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 w grze, które umożliwiają graczom przełączanie się między IGA. Gdy gracze przełączają konta, pozostają uwierzytelnieni na platformie Usług gier Play za pomocą PGS, a Ty nadal wysyłasz ich dane związane z osiągnięciami i innymi funkcjami PGS na podstawie trwałego identyfikatora gracza.
Ciągłość na różnych platformach dzięki SiWG
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 usługach gier Play w wersji 1 przycisk Google Play często obsługiwał logowanie się 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 konta 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ę przez 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
Ten krok jest wymagany do zainicjowania i uwierzytelnienia gry:
Zaimplementuj 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ę. Gracze, którzy nie mają konta, zostaną poproszeni o jego utworzenie.
Automatycznie wywoływane prośby o utworzenie profilu pojawiają się domyślnie, gdy uruchamiasz grę bez profilu w Usługach gier Play.
Uwierzytelnianie w grze
Po pomyślnym uwierzytelnieniu na platformie deweloperzy powinni wykonać te czynności, aby umożliwić graczom dostęp do IGA, w zależności od bieżącego stanu gry:
- Jeśli na urządzeniu istnieje aktywna sesja gry, zezwól graczowi na wznowienie bieżącej sesji.
- Jeśli nie ma aktywnej sesji gry:
- W przypadku bezproblemowego przywracania, gdy ostatnia gra IGA jest powiązana z identyfikatorem odtwarzacza PGS, automatycznie przywróć powiązaną grę IGA.
- W przeciwnym razie wyświetl graczowi ekran logowania lub tworzenia konta w aplikacji. Gracze mogą następnie wybrać preferowaną metodę uwierzytelniania, aby utworzyć lub zalogować się na istniejące konto IGA.
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 uwierzytelniania serwera lub pobieranie kodów uwierzytelniania serwera.
Wytyczne 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 odtwarzacz
Ten proces dotyczy użytkownika, który uruchamia grę po raz pierwszy na urządzeniu, na którym nie grał wcześniej.
- Po uruchomieniu pakiet SDK usług gier Play inicjuje uwierzytelnianie tożsamości platformy użytkownika (identyfikator gracza w usługach gier Play).
- 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.
- Gdy gracz utworzy lub wybierze IGA, gra powiąże to konto z wybranym identyfikatorem podstawowym w swoim systemie backendowym.
- Gra wiąże też wybraną IGA z identyfikatorem gracza PGS, oznaczając ją jako ostatnią IGA, w którą gracz grał, aby umożliwić bezproblemowe przywracanie.
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 przejścia do aplikacji.
- Gdy gracz uruchomi aplikację, usługi gier Play w tle przeprowadzą ciche uwierzytelnianie, udostępniając Ci identyfikator gracza, który umożliwia śledzenie postępów w zdobywaniu osiągnięć i korzystaniu z innych funkcji usług gier Play.
- W odpowiednich przypadkach gra pomija ekrany logowania i natychmiast loguje gracza w aktywnej sesji IGA lub w ostatniej grze 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 IGA, ale połączenie z platformą PGS pozostaje aktywne.
- Gdy gracz zaloguje się za pomocą innego dostawcy tożsamości, gra powiąże to nowe konto z bieżącym identyfikatorem gracza w usługach gier Play jako ostatnio używanego dostawcę tożsamości tylko na potrzeby bezproblemowego przywracania.
Łatwe 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.
- Po uruchomieniu usługi gier Play uwierzytelniają użytkownika i przekazują do gry 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 ostatnia używana tożsamość IGA jest już połączona z tym identyfikatorem usług gier Play.
- Jeśli link zostanie znaleziony, gra automatycznie przywróci postępy gracza i zaloguje go, pomijając ekran logowania ręcznego.
- W przeciwnym razie gra wyświetli ekran logowania.
- Gracz wybiera metodę logowania i loguje się w IGA.
- Następnie gra wiąże 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ą 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 w usługach gier Google Play.
