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ą.
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ę. Ci gracze zostaną poproszeni o utworzenie takiego konta.
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 umożliwić graczom logowanie się w grze, użyj tego przepływu 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 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ść powiązana 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 następuje utworzenie profilu i próba uwierzytelnienia użytkownika lub utworzenia nowego konta.
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 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.