Interfejs Recall API pozwala grom używać usług gier Play (PGS) jako uzupełnienie z istniejących mechanizmów logowania, np. przez Google, i bezproblemowej synchronizacji graczy logowania się na różnych urządzeniach w celu zmniejszenia liczby rezygnacji i zwiększyć utrzymanie użytkowników w ciągu 1 dnia. Interfejs API do zarządzania połączeniami między kontem usług gier Play użytkownika a usługą gier ich konta w grze, przechowując tokeny wycofywania na serwerach Google. Oto przykładowy scenariusz zastosowania interfejsu Recall API:
Użytkownik gra w grę, w której deweloper dysponuje systemem tożsamości do śledzenia postępów użytkownika oraz korzystać z usług gier Google Play równolegle z innymi metodami uwierzytelniania, i logowania użytkowników w grach. W tym przykładzie użytkownik jest zalogowany w usługach gier Play. Laurę i tworzy konto w grze u system tożsamości o nazwie Racer94. Gdy użytkownik gra w grę, serwer gry dewelopera synchronizuje postępy.
Oprócz tego deweloper zapisuje token wycofywania w Google, który odpowiada kontu użytkownika w grze. Google automatycznie zapisuje który wycofuje token z profilem usług gier Play użytkownika.
Użytkownik decyduje się teraz zagrać w grę w Grach Google Play na PC w pierwszej kolejności obecnie się znajdujesz. użytkownik jest automatycznie logowany na swoje konto w usługach gier Play, klient gry sprawdza, czy są jakieś postępy w tej usłudze użytkownika. Serwer gry wysyła zapytanie do Google, by sprawdzić, czy istnieją tokeny dla na tym koncie usług gier Play. W takiej sytuacji Google odsyła token wycofywania, serwer gry używa tego tokena do znalezienia powiązanego konta użytkownika. Racer94, i przywróć jego postępy. Ponieważ logowanie się w usługach gier Play bezproblemowej pracy, postęp użytkownika jest przywracany przez aplikację bez gdy użytkownik ma podać nazwę użytkownika lub hasło. Ponadto programista mogą logować się w usługach gier Play za pomocą obecnego systemu tożsamości i korzystać z Google do przechowywania połączenia między postępami gracza a jego kontem w usługach gier Play.
Jak widać w powyższym przykładzie, reklamodawcy mogą wykonać 2 główne działania: interfejs Recall API:
- przechowywanie tokena w Google, gdy użytkownik loguje się w jednej z gier. kont.
- pobieranie tokena użytkownika, aby przywrócić mu go w grze. kont.
Oprócz tokenów wycofywania interfejs Recall API wymaga też stabilnego identyfikatora powiązanego z kontem w grze (tzw. persona) w celu egzekwowania zasad. ograniczenia mocy zbioru. Możesz określić profil odbiorców, jako etykietę reprezentującą konto użytkownika w grze na tożsamości, a token wycofywania jako klucz używany do przywracania konto użytkownika w grze. Nie wolno ponownie używać wartości profili klientów ani tokenów w różnych Projekty w PGS. Tokeny wycofywania mogą się z czasem zmieniać, ale profil klienta powinien być stabilny. zgodnie z kontem w grze.
Reguły mocy zbioru
Interfejs Recall API wymusza relację 1:1 między profilami usług gier Play a profilami w grze na kontach (nazywanych regułami mocy zbioru), przy czym do jednego profilu można przypisać tylko połączony z 1 profilem usług gier Play, a 1 profil usług gier Play można połączyć tylko z 1 profil. Profil użytkownika jest używany jako stały identyfikator konta w grze, bo tokeny wycofywania mogą się z czasem zmieniać.
Profil powiązany z profilem usług gier Play może się też zmieniać w miarę upływu czasu (ponieważ różni się konta w grze są połączone z profilem usług gier Play).
Szczegółowe instrukcje techniczne dotyczące przechowywania pobieranie tokenów wycofywania
W tej sekcji omówiono proces techniczny między klientem gry, serwerem gry, i serwery Google podczas przechowywania i pobierania tokenów wycofywania:
Krok 1. Zaloguj się na konto użytkownika usług gier Play i pobierz identyfikator sesji
Gra inicjuje pakiet SDK usług gier Play i próbuje zalogować użytkownika w tych usługach.
Jeśli użytkownik jest zalogowany, poproś o identyfikator sesji z pakietu SDK do gier klienta gier i zażądać tokena OAuth 2.0 z backendu OAuth Google. identyfikatora sesji i tokenów OAuth 2.0 są używane do komunikowania się z Grami Google. z backendem.
Krok 2. Pobierz dowolny dostępny token wycofywania
Prośba o dowolny token wycofywania powiązany z kontem użytkownika usług gier Play. Jeśli token jest obecny, przejdź do kroku 3a i przywróć postęp. Jeśli natomiast jest to nowy użytkownik i nie ma on tokena, przejdź do Krok 3b i zapisz nowy token.
Krok 3a. Jeśli token jest dostępny, przywróć postęp
Jeśli token jest dostępny, pobierz go i odszyfruj oraz przywróć dane użytkownika.
Krok 3b. Jeśli nie ma tokena, zapisz go
Ponieważ nie ma tokena, postęp nie zostanie przywrócony. Użytkownik się loguje z systemem tożsamości dewelopera, a jeśli nie, tworzy nowe konto istnieje.
utworzyć zaszyfrowany token wycofywania, który koduje konto użytkownika w grze; wyślij go do Google wraz z identyfikatorem sesji i tokenem OAuth 2.0. W tym momencie Google tworzy powiązanie między wysłanym tokenem wycofywania a kwotą konto usług gier Play gracza.
Procesy dotyczące użytkowników bez profilu usług gier Play
Tokeny wycofywania dla użytkownika, który nie utworzył jeszcze profilu usług gier Play, możesz przechowywać do za pomocą trybu bezprofilowego. Musisz jednak pamiętać o 2 ważnych kwestiach:
- Nie możesz pobrać tokenów dla użytkownika, który nie ma profilu usług gier Play. Profil pojawia się automatycznie, gdy użytkownik spróbuje zalogować się w grze. z usługami gier Play na drugim urządzeniu.
- Musisz przestrzegać dodatkowych wytycznych
oraz upewnić się, że otrzymasz odpowiednie powiadomienie opisujące następujące elementy oraz
uzyskania odpowiedniej zgody użytkownika:
- Udostępnianie danych Google w celu włączenia konta Gier Play dzięki funkcji łączenia.
- Dostępność ustawień do zarządzania tym udostępnianiem, takich jak Gry Play ustawieniach.
- Przetwarzanie takich danych zgodnie z Polityką prywatności Google Zasady.
Przechowywanie pary tokena i profilu klienta
- Użytkownik bez profilu usług gier Play otwiera grę, która nie ma profilu czułości .
- Pakiet SDK do gier uruchamia automatyczne logowanie, które kończy się niepowodzeniem, ponieważ użytkownik brak profilu usług gier Play.
- Pakiet SDK do gier wyświetla pasek powiadomień, który informuje użytkownika, że gra zawiera integrację z Google. Ten pasek powiadomień jest aktywny – użytkownik może wyłączyć do momentu utworzenia profilu.
- Gra prosi o dostęp do wycofania. Pamiętaj, że usługi gier Play odrzuca prośby o cofnięcie dostępu gdy na urządzeniu są profile usług gier Play lub gdy nie ma konta Google. Konta na urządzeniu. W takim przypadku gra powinna kontynuować grę bez użycia Usługi gier Play.
- Gdy użytkownik zaloguje się na swoje konto w grze, gra tworzy token, profil klienta odpowiadający jego kontu w grze. Gra przechowuje tę parę w Google. Gra może później zapisać więcej tokenów, jeśli loguje się na inne konta w grze.
Uruchamianie gry na nowym urządzeniu
- Użytkownik bez profilu usług gier Play otwiera grę z włączonym wycofywaniem bezprofilowym na urządzeniu.
- Gra rejestruje bezprofilowy token wycofywania zgodnie z opisem w sekcji Przechowywanie tokena i profil klienta.
- użytkownik uruchomi tę samą grę na innym urządzeniu z tym samym kontem, konfiguracji.
- Pakiet SDK do gier rozpoczyna tworzenie profilu. Użytkownik może przejrzeć i odrzucić prośbę zapisane wcześniej tokeny wycofywania. Użytkownik tworzy teraz profil usług gier Play.
- Automatyczne logowanie w usługach gier Play się zakończy i gra otrzyma stanu uwierzytelnienia.
- Gra normalnie pobiera tokeny wycofywania dla użytkownika.
Dalsze kroki
Aby zintegrować interfejs Recall API z klientem i serwerem gry, ten podręcznik implementacji.