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.
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 osiągnięciach.
- Oddzielenie: nie możesz używać usług Gier Play jako podstawowego 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 dla każdego gracza, który zaloguje się w Twojej grze 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 dla użytkownika, gdy 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 wiąże 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 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.
Działanie na wielu platformach dzięki logowaniu się przez Google
Aby ułatwić graczom przenoszenie postępów między Androidem, iOS i internetem, użyj 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 osobne 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 Androidzie, jak i w 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 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 uruchomią Twoją grę. Ci gracze zostaną poproszeni o utworzenie profilu.
Gdy uruchamiasz grę bez profilu w usługach Gier Play, domyślnie automatycznie pojawiają się prośby o utworzenie profilu.
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:
- Jeśli na urządzeniu jest aktywna sesja gry, zezwól graczowi na wznowienie bieżącej sesji.
- Jeśli nie ma aktywnej sesji gry:
- 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.
- 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 OAuth.
Jeśli potrzebujesz dodatkowych zakresów 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.
- 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).
- 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.
- Gdy gracz utworzy lub wybierze konto IGA, gra powiąże to konto z wybranym identyfikatorem podstawowym w backendzie.
- 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.
- Gdy gracz uruchamia aplikację, usługi Gier Play uwierzytelniają się w tle, udostępniając Ci identyfikator gracza, aby śledzić postępy w osiągnięciach i innych funkcjach Gier Play.
- Jednocześnie, w stosownych przypadkach, gra pomija ekrany logowania i natychmiast loguje gracza na aktywną sesję IGA lub ostatnio używane konto IGA powiązane z jego identyfikatorem gracza, aby mógł od razu wznowić grę.
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.
- Gracz wylogowuje się z bieżącego konta IGA, ale połączenie z platformą usług Gier Play pozostaje aktywne.
- 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.
- Po uruchomieniu usługi Gier Play uwierzytelniają użytkownika i udostępniają grze identyfikator gracza w usługach Gier Play.
- Gra sprawdza swój backend (lub pobrany token do pobrania danych, jeśli używasz interfejsu Recall API), aby sprawdzić, czy ostatnio używane konto IGA jest już połączone z tym identyfikatorem w usługach gier Play.
- Jeśli znajdzie połączenie, gra automatycznie przywraca postępy gracza i loguje go, pomijając całkowicie ręczny ekran logowania.
- W przeciwnym razie gra wyświetla graczowi ekran logowania.
- Gracz wybiera metodę logowania i loguje się na konto IGA.
- Gra powiąż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ą 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 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.
