Aby zintegrować grę z usługami gier Play, najpierw zaimplementuj uwierzytelnianie na platformie. Jest to wymagane, aby uzyskać dostęp do wszystkich innych funkcji, takich jak osiągnięcia, tabele wyników i wydarzenia.
Aby spełnić wskazówki dotyczące wrażeń użytkowników w programie Level Up w Usługach gier Google Play, Twoja gra musi być zgodna z zalecanym procesem uwierzytelniania.
Inicjowanie i uwierzytelnianie
Aby zainicjować grę i przeprowadzić uwierzytelnianie, musisz wykonać te czynności:
- 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. Jest to wymagany krok, 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.
Po pomyślnej autoryzacji obecni użytkownicy usług gier Play zobaczą wiadomość powitalną.
Opcje tworzenia profilu
Profil w usługach gier Play jest niezbędny, aby gracze mogli korzystać z platformy. 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.
Możesz wybrać odpowiednie rozwiązanie dla użytkowników, korzystając z jednej z tych opcji:
Automatycznie wywoływane prośby o utworzenie profilu Prośby o utworzenie profilu pojawiają się domyślnie automatycznie po uruchomieniu gry bez profilu w Usługach gier Play.
Prośba o utworzenie profilu po uruchomieniu gry (kliknij, aby powiększyć). Wyłączanie monitów o utworzenie profilu przy uruchamianiu i dodawanie monitów ręcznych po zainicjowaniu gry Monity o utworzenie profilu wywoływane automatycznie możesz wyłączyć w pliku manifestu. Dzięki temu użytkownicy bez profilu usług gier Play mogą korzystać z zastosowanych przez Ciebie metod uwierzytelniania bez natychmiastowego wyświetlania prośby o utworzenie profilu usług gier Play.
Użytkownicy mogą logować się za pomocą dowolnego dostawcy tożsamości, ale zalecamy wyświetlanie monitu o utworzenie profilu Uzyskiwanie wyniku uwierzytelniania, aby zachęcić do rejestracji w Grach Play. Wyświetlaj ten komunikat według własnego uznania, 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.
Zalecany proces uwierzytelniania
Aby spełnić wytyczne dotyczące wrażeń użytkowników w Google Play Games Level Up, sprawdź, czy spełniasz wymagania dotyczące ciągłości rozgrywki. Aby umożliwić graczom logowanie się w grze, użyj tego przepływu uwierzytelniania:
- Podczas uruchamiania gry zapoznaj się z opcjami tworzenia profilu i wybierz jedną z nich.
- Jeśli logowanie automatyczne nie działa lub użytkownik je odrzuci, wyświetl przycisk logowania ręcznego, aby użytkownik mógł zalogować się później.
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 niej za pomocą uwierzytelniania w usługach gier Play. Twoja integracja klienta gry, integracja serwera gry i usługa zapisywania w chmurze mogą używać 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.
Zakresy 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 Google Drive 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.
Wiele usług uwierzytelniania
Usługi gier Play zapewniają tożsamość gracza na Androidzie, ale nie musi to być jedyna tożsamość połączona z użytkownikami. Możesz jednocześnie uwierzytelniać graczy za pomocą usług gier Play, identyfikatora sieci społecznościowej i własnego systemu identyfikatorów w grze.
Recall API
Interfejs Recall API umożliwia grom w usługach gier Play zarządzanie połączeniami między użytkownikami a ich kontami w grze przez przechowywanie tokenów Recall na serwerach Google. Więcej informacji o włączaniu tej funkcji znajdziesz w artykule Integrowanie interfejsu PGS Recall API z grą.
Integracja klienta gry
Podczas integrowania uwierzytelniania z projektem gry zalecamy następujący przepływ użytkownika:
Podczas uruchamiania gry pojawia się opcja utworzenia profilu, która próbuje zalogować użytkownika lub utworzyć nowe konto.
Jeśli automatyczne uwierzytelnianie nie działa lub użytkownik je odrzuci, wyświetl przycisk ręcznego logowania, aby użytkownik mógł zalogować się później.
Informacje o integrowaniu uwierzytelniania w projekcie gry znajdziesz w przewodniku dla danego typu projektu:
Integracja serwera gry
Kod autoryzacji serwera możesz uzyskać, wywołując funkcję requestServerSideAccess, gdy potwierdzisz, że odtwarzacz jest uwierzytelniony. Przekaż ten kod autoryzacji serwera do serwera backendu gry, aby komunikować się bezpośrednio z serwerami usług gier Play. Ta komunikacja umożliwia serwerowi dostęp do danych gracza, w tym:
- Identyfikator gracza
- Profil
- Lista znajomych
- Postępy w grze
- Osiągnięcia
Serwer używa następnie tego kodu autoryzacji z interfejsem API REST, aby bezpiecznie komunikować się z serwerami usług gier Play. Więcej informacji znajdziesz w artykule Dostęp do Usług gier Play po stronie serwera.
Limit żądań logowania
Istnieje dzienny limit żądań logowania w usługach gier Play. Więcej informacji znajdziesz w artykule Zarządzanie dziennym limitem.