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
Jest to wymagany krok 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 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.
Dotychczasowi użytkownicy usług gier Play po pomyślnej autoryzacji zobaczą wiadomość powitalną.
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.
Zalecany proces uwierzytelniania
Aby spełnić wytyczne dotyczące wrażeń użytkownika w Google Play Games Level Up, sprawdź, czy spełniasz wymagania dotyczące ciągłości rozgrywki. Aby gracze mogli logować się do Twojej gry, użyj tego procesu uwierzytelniania:
- Podczas uruchamiania gry zaimplementuj automatycznie wywoływane tworzenie profilu.
- Jeśli automatyczne uwierzytelnianie się nie powiedzie lub je odrzucisz, wyświetl przycisk logowania ręcznego, aby umożliwić uwierzytelnienie w późniejszym czasie.
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ć 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 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.
Wiele usług uwierzytelniania
Usługi gier Play zapewniają tożsamość gracza na Androidzie, ale nie musi to być jedyna tożsamość powiązana z użytkownikami. Możesz uwierzytelniać graczy jednocześnie 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 zarządzanie połączeniami między użytkownikami usług gier Play a ich kontami w grze przez przechowywanie tokenów Recall na serwerach Google. Więcej informacji o włączaniu tej funkcji znajdziesz w artykule Integracja interfejsu PGS Recall API z grą.
Integracja klienta gry
Podczas integrowania uwierzytelniania z projektem gry zalecamy następujący proces:
Podczas uruchamiania gry następuje tworzenie profilu, które próbuje uwierzytelnić użytkownika lub utworzyć nowe konto.
Jeśli automatyczne uwierzytelnianie się nie powiedzie lub je odrzucisz, wyświetl przycisk ręcznego logowania, aby umożliwić uwierzytelnienie w późniejszym czasie.
Informacje o integrowaniu uwierzytelniania w projekcie gry znajdziesz w dokumentacji dotyczącej Twojego typu projektu:
Integracja serwera gry
Kod autoryzacji serwera możesz uzyskać, wywołując funkcję requestServerSideAccess, gdy potwierdzisz, że gracz jest uwierzytelniony. Przekaż ten kod autoryzacji serwera do backendowego serwera 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 po stronie serwera do usług Gier Play.
Limit żądań logowania
Istnieje dzienny limit żądań logowania w usługach gier Play. Więcej informacji znajdziesz w artykule Zarządzanie dziennym limitem.