Tożsamość i łączenie kont

Używaj uwierzytelniania w usługach gier Google Play, aby usprawnić uwierzytelnianie użytkowników na platformie w Twojej grze. Zainicjuj pakiet SDK usług gier Play, aby wywołać uwierzytelnianie, co eliminuje konieczność stosowania osobnego procesu uwierzytelniania na platformie.

Łączenie kont użytkowników w celu zapewnienia ciągłości i odtwarzania na różnych urządzeniach

Gracze grają w ulubione gry na różnych urządzeniach i platformach, w tym na telefonach komórkowych, tabletach i komputerach. Oczekują oni, że będą mogli bezproblemowo wznowić rozgrywkę dokładnie w miejscu, w którym ją przerwali, niezależnie od wybranego urządzenia.

Znaczącą barierą, która często prowadzi do rezygnacji użytkowników, jest konieczność oddzielnego logowania się na każdym nowym urządzeniu. Użytkownicy muszą mieć możliwość natychmiastowego rozpoczęcia rozgrywki bez niepotrzebnych przerw.

Aby zapewnić płynną kontynuację rozgrywki i możliwość grania na różnych urządzeniach, musisz wdrożyć 2 kluczowe funkcje:

Proces uwierzytelniania w usługach gier Play zapewnia elastyczne opcje identyfikatorów graczy. Te opcje umożliwiają zintegrowanie usług gier Play z Twoim dotychczasowym rozwiązaniem do obsługi tożsamości.

Nowa integracja usług gier Play

W przypadku gier bez integracji z usługami gier Play interfejs Recall API upraszcza konfigurację backendu, zarządzając powiązaniami kont i przechowując połączenie między kontem użytkownika w grze a kontem usług gier Play.

Łączenie kont za pomocą interfejsu Recall API

Interfejs Recall API to zalecane rozwiązanie do łączenia kont użytkowników w grach na różnych platformach. Ten interfejs API jest szczególnie przydatny w przypadku gier, które nie są zintegrowane z usługami gier Play lub korzystają z dodatkowych rozwiązań do uwierzytelniania na platformie poza usługami gier Play.

Interfejs Recall API upraszcza konfigurację backendu gry, zarządzając powiązaniami kont.

  • Uproszczony backend: interfejs API upraszcza konfigurację backendu gry na potrzeby łączenia kont.
  • Powiązania zarządzane przez Play: Play przechowuje powiązania między kontami użytkowników w grach (w tym kontami innych firm) a ich kontami w Usługach gier Play.
  • Przywracanie postępów: deweloperzy generują i wysyłają do Google Play tokeny wycofywania, które można później pobrać, aby przywrócić postępy użytkownika w grze.

Podczas wdrażania interfejsu Recall API deweloperzy muszą sprawdzić, czy tokeny Recall są nieprzezroczystymi ciągami znaków. Te tokeny nie mogą zawierać żadnych informacji wrażliwych ani umożliwiających identyfikację graczy (takich jak imię i nazwisko, adres e-mail czy dane demograficzne).

Podczas generowania tokenów wycofania gry muszą używać solidnych algorytmów szyfrowania, aby chronić dane użytkowników i zapewnić bezpieczeństwo.

Więcej informacji o działaniu funkcji Recall znajdziesz w artykule Recall API .

Aby wdrożyć funkcję interfejsu Recall API, zapoznaj się z artykułem Integracja interfejsu Recall API usług gier Play z grą.

Zarządzanie wieloma kontami za pomocą interfejsu Recall API

Zarządzając wieloma kontami tego samego użytkownika, możesz traktować każde z nich jako odrębną personę. Takie podejście pozwala dostosowywać treści do konkretnego kontekstu użytkownika.

Aby wdrożyć to podejście, wykonaj te czynności:

Dostępne są różne opcje zasad (np. automatyczne przywracanie ostatniego konta), ale zdecydowanie zalecamy wyświetlanie użytkownikowi odpowiedniego komunikatu. W tym celu wyświetl im prośbę o wybranie konta, które chcą przywrócić. Zapewnij im przy tym przejrzystość i wygodę.

Istniejąca integracja z usługami gier Play

W tej sekcji dowiesz się, jak zintegrować grę z usługami gier Play przez powiązanie kont graczy. Dowiedz się, jak używać identyfikatorów graczy do identyfikowania uwierzytelnionych graczy i zarządzania wieloma kontami gier dla jednego użytkownika Usług gier Play.

Powiąż z Player_id

Identyfikator gracza to identyfikator konta gracza w usługach gier Play. Twoja gra może pobrać identyfikator gracza dla każdego gracza, który uwierzytelnił się w niej za pomocą usług gier Play.

Gry, w których backend jest skonfigurowany za pomocą usług gier Play Player_Id lub które wymagają obsługi użytkowników będących dziećmi, powinny używać Player_Id i łączyć swoje konta w grze oraz konta innych firm z Player_Id.

Poznaj działanie identyfikatorów graczy:

  • Spójność w ramach gry: identyfikator gracza pozostaje spójny dla użytkownika na różnych urządzeniach, gdy gra on w tę samą grę.
  • Niespójne w różnych grach: identyfikatory graczy nie zawsze są spójne, gdy użytkownik gra w różne gry.

Więcej informacji znajdziesz w artykule o identyfikatorach graczy nowej generacji.

Zarządzanie wieloma kontami użytkowników za pomocą powiązania

Aby połączyć wiele kont użytkowników z jednym kontem Usług gier Play, utwórz w tabeli mapowanie typu „jeden do wielu”.

Tożsamość Google na różnych platformach przy użyciu funkcji Zaloguj się przez Google

Logowanie przez Google (SiwG) to podstawowe rozwiązanie Google do zarządzania tożsamością, które umożliwia deweloperom gier bezpieczne otrzymywanie informacji o profilu gracza: imienia i nazwiska, adresu e-mail oraz zdjęcia profilowego.

Kluczową zaletą logowania się przez Google jest jego szeroka dostępność na różnych platformach, w tym w przeglądarce, na Androidzie i iOS. Zapewnia szybkie, bezpieczne i znane logowanie, któremu gracze ufają.

Powiąż z polem sub tokena tożsamości Google

Aby zapewnić spójność na różnych platformach, możesz wdrożyć strategię uwierzytelniania, która łączy system kont w grze z unikalnym identyfikatorem konta Google. To podejście wykorzystuje uproszczone uwierzytelnianie w usługach gier Play na Androidzie, a na innych platformach, takich jak iOS i internet, używa standardowego pakietu SDK Logowanie przez Google.

Kluczem do tej strategii jest pole sub z tokena identyfikatora Google. Pole sub (lub „subject”) to unikalny i trwały identyfikator konta użytkownika Google. Będziesz używać tego identyfikatora jako „pomostu” do łączenia wszystkich sesji gracza z jednym kontem w grze na backendzie.

Oto ogólny przebieg procesu:

  • Na Androidzie: gra inicjuje pakiet SDK Usług Google Play, aby automatycznie wywoływać uwierzytelnianie na urządzeniach z Androidem. Konfigurujesz integrację Usług gier Play w wersji 2, aby żądać 3 zakresów logowania: email, profile i openid. Są to te same zakresy, o które prosi standardowy pakiet SDK do logowania się przez Google. Dzięki temu możesz pobrać token identyfikatora, który zawiera pole sub gracza.
  • W przypadku internetu i iOS: gra korzysta ze standardowych pakietów SDK Logowanie przez Google w internecie i Logowanie przez Google na iOS i macOS. Gdy użytkownik się zaloguje, pakiet SDK SiwG udostępni token identyfikatora, który zawiera też pole sub użytkownika.
  • Powiązanie kont: ponieważ użytkownik loguje się na obu platformach za pomocą tego samego konta Google, otrzymywane pole sub będzie identyczne. Możesz wtedy bez obaw powiązać tę wartość sub z wewnętrznym identyfikatorem użytkownika w swoim rozwiązaniu do zarządzania tożsamością, aby zapewnić spójną obsługę użytkowników.

Integracja na Androidzie

Na Androidzie głównym punktem integracji będzie pakiet SDK usług gier Google Play. Kluczem jest skonfigurowanie klienta logowania usług gier Google Play tak, aby żądał dodatkowych zakresów logowania. Umożliwia to pobranie kodu autoryzacji po stronie serwera, który backend może wymienić na token identyfikatora zawierający informacje o użytkowniku, w tym unikalne pole sub.

Ogólnie wdrożenie obejmuje:

  1. Skonfiguruj identyfikatory klienta w ujednoliconym projekcie: przed integracją musisz skonfigurować Usługi gier Play w Konsoli Google Play, aby uzyskać identyfikatory klienta OAuth 2.0.

  2. Skonfiguruj usługi gier Play: zanim zaczniesz, musisz dodać grę w Konsoli Google Play i zintegrować z nią uwierzytelnianie na platformie usług gier Play.

  3. Dodaj przycisk Zaloguj się przez Google: na stronie logowania lub ekranie ustawień użytkownika w grze dodaj przycisk „Zaloguj się przez Google”. Ten przycisk wywoła proces logowania lub rejestracji. Podczas tworzenia tego przycisku zalecamy przestrzeganie wskazówek dotyczących marki „Zaloguj się przez Google”. Przycisk powinien co najmniej wyraźnie wyświetlać tekst „Google” lub „Zaloguj się przez Google”. W wytycznych znajdziesz też komponenty UX, które możesz pobrać i wykorzystać w swojej grze.

  4. Poproś o kod uwierzytelniania serwera z zakresami logowania: gdy gracz kliknie przycisk, gra poprosi o jednorazowy kod uwierzytelniania serwera. Najważniejszym krokiem jest skonfigurowanie tej prośby tak, aby zawierała te zakresy logowania: EMAIL, PROFILE i OPEN_ID.

    Sposób konfiguracji zależy od środowiska programistycznego:

  5. Wymień kod autoryzacji i zweryfikuj token identyfikatora na serwerze backendu: wyślij kod autoryzacji z poprzedniego kroku na serwer backendu. Na serwerze postępuj zgodnie ze standardowym przewodnikiem po procesie wymiany kodu OAuth 2.0, aby wymienić kod na token identyfikatora, token dostępu i token odświeżania. Zgodnie z opisem w przewodniku musisz zweryfikować token identyfikatora na swoim serwerze.

  6. Powiąż pole sub: po pomyślnym zweryfikowaniu tokena identyfikatora wyodrębnij pole sub z jego ładunku. Użyj tej wartości sub jako unikalnego klucza tożsamości Google w swoim rozwiązaniu do zarządzania tożsamością.

    • Jeśli ta wartość sub już istnieje w Twojej bazie danych, użytkownik ma już powiązane konto. Zaloguj dziecko na odpowiednie konto gry.

    • Jeśli wartość sub nie istnieje, możesz utworzyć nowe konto użytkownika w systemie kont w grze powiązane z tym identyfikatorem sub lub połączyć je z istniejącym kontem użytkownika w systemie kont, dopasowując informacje o użytkowniku (np. adres e-mail) podane w tokenie identyfikatora.

Integracja na iOS, w przeglądarce i na innych platformach

Na platformach innych niż Android, iOS, internet i PC będziesz używać standardowych pakietów SDK logowania przez Google. Cel jest taki sam jak w przypadku procesu na Androidzie: bezpieczne uzyskanie tokena identyfikatora Google, przesłanie go do backendu i użycie pola sub do połączenia konta.

Ogólnie wdrożenie obejmuje:

  1. Integracja po stronie klienta: postępuj zgodnie z oficjalną dokumentacją, aby zintegrować pakiet SDK Logowanie przez Google z platformą. Te przewodniki opisują cały proces po stronie klienta, od renderowania przycisku Zaloguj się przez Google po pobieranie tokena identyfikatora.

  2. Logika backendu: wyślij token identyfikatora (lub kod autoryzacji) do backendu. Serwer wykonuje następnie dokładnie taką samą weryfikację i logikę sub powiązania pól jak w krokach 4 i 5 sekcji „Integracja na Androidzie”.

Pole sub we wszystkich tych procesach logowania przez Google jest identyczne z polem pobranym z procesu Usług gier Google Play na Androidzie (w przypadku tego samego konta Google), więc ten proces skutecznie łączy konto użytkownika na wszystkich platformach.