Pakiet SDK usług gier Google Play w wersji 1 korzysta z usługi Logowanie przez Google na Androida, która jest wycofana i zostanie usunięta z pakietu SDK do uwierzytelniania w Usługach Google Play (com.google.android.gms:play-services-auth) w 2025 r.
Nowe aplikacje z grami mogą korzystać z wersji 1 do 2025 roku. Usunięcie logowania przez Google powoduje problemy z zależnościami w przypadku istniejących aplikacji z grami. Migracja istniejących gier i aplikacji z pakietu SDK do gier w wersji 1 na pakiet SDK do gier w wersji 2 rozwiązuje problemy z zależnościami wprowadzone przez usunięcie logowania przez Google.
Ten dokument pomoże Ci zrozumieć interakcje między aplikacją gier a różnymi pakietami SDK. W tym dokumencie porównujemy też funkcje aplikacji z funkcjami pakietów SDK usług gier Play w wersjach 1 i 2.
Interakcje z pakietem SDK
Diagramy ilustrują interakcję między aplikacją do gier na Androida, usługami podstawowymi Google Mobile Services (GMS), usługami gier Play a serwerem gier innej firmy. Opisuje, jak aplikacja korzysta z usług Google do uwierzytelniania i funkcji gry, a także jak wchodzi w interakcje z osobnym systemem innej firmy.
games v2 (bieżąca)
games v1 (starsza wersja)
Poniżej znajdziesz krótkie omówienie komponentów i pakietów SDK:
- Aplikacja Gry.
- Jest to aplikacja do gry użytkownika działająca na urządzeniu z Androidem.
- Składa się z 2 głównych komponentów:
- pakietu SDK do gier w wersji 1 lub 2. Pakiet SDK po stronie klienta, który odpowiada za interakcje z Usługami gier Play.
- Pakiet SDK do uwierzytelniania Pakiet Google Play Services Auth SDK odpowiada za obsługę procesów uwierzytelniania i autoryzacji użytkowników w grach w wersji 1.
- Oba pakiety SDK komunikują się za pomocą języka AIDL (Android Interface Definition Language), co wskazuje na wzorzec komunikacji między różnymi procesami lub usługami.
- GMS Core, czyli Usługi Google Play.
- Jest to warstwa należąca do Google w systemie Android.
- Aplikacja do gier korzysta z 2 modułów GMS Core:
- Moduł gier udostępnia funkcje związane z grami, takie jak tablice wyników, osiągnięcia i zarządzanie stanem gry.
- Moduł autoryzacji. Obsługuje operacje uwierzytelniania i autoryzacji użytkowników.
- Pakiety SDK do gier i uwierzytelniania w aplikacji do gier komunikują się z odpowiednimi modułami za pomocą interfejsów AIDL, co wskazuje na komunikację międzyprocesową (IPC).
- Brama usług gier Play
- Logiczna brama, która pośredniczy w komunikacji między GMS Core a serwerem usług gier Play.
- Obsługuje żądania interfejsu API, przekształcanie danych i uwierzytelnianie w komunikacji z serwerem.
- Serwer usług gier Play
- Reprezentuje usługi backendu usług gier Play odpowiedzialne za przechowywanie danych gry, zarządzanie kontami użytkowników i ułatwianie korzystania z funkcji trybu wieloosobowego.
- Bramka gier innych firm
- Jeśli Twoja aplikacja do gier kwalifikuje się jako aplikacja innej firmy, biblioteka klienta komunikuje się z serwerami usług gier Play za pomocą serwerów gier innej firmy.
- Oznacza to, że aplikacja może też uwierzytelniać się u innego dostawcy usług.
- Serwer gier firmy zewnętrznej.
- Reprezentuje opcjonalny serwer zewnętrzny, z którym aplikacja do gier może wchodzić w interakcje, prawdopodobnie w celu korzystania z niestandardowych funkcji lub zarządzania danymi.
- Komunikacja z aplikacją odbywa się za pomocą bramy gier innych firm.
Porównanie funkcji
W tej tabeli znajdziesz porównanie funkcji pakietów SDK gier w wersji 1 i 2:
Funkcja |
Pakiet SDK do gier w wersji 1 |
pakiet SDK do gier w wersji 2 |
|---|---|---|
Uwierzytelnianie |
Wymagana integracja z play-services-auth. |
Uproszczone i zoptymalizowane; nie play-services-auth
wymagane. |
Autoryzacja |
Dodatkowy kod dotyczący powodzenia, błędów i ponownych prób. |
Zarządzane przez pakiet SDK |
Token dostępu serwera |
Może prosić o dodatkowe zakresy OAuth 2.0 za pomocą GoogleSigninClient.Dodatkowy kod do obsługi błędów podczas logowania. |
Może prosić o 3 podstawowe zakresy tożsamości OAuth 2.0 z GamesSignInClient podczas wysyłania prośby o dostęp po stronie serwera do interfejsów API usług gier Play.
Więcej informacji znajdziesz w sekcjach Dostęp do Usług gier Play po stronie serwera i Pobieranie kodów uwierzytelniania serwera. |
Proces logowania |
Używa GoogleSigninClient.Dodatkowy kod do obsługi kodu standardowego na potrzeby automatycznego logowania i obsługi błędów. |
Używa GamesSignInClient.Pakiet SDK obsługuje kod standardowy, automatyczne logowanie i obsługę błędów. |
Wyskakujące okienko powitalne |
Wymagany jest dodatkowy kod. Deweloperzy mogą kontrolować jego umiejscowienie i czas wyświetlania. |
Nie wymaga dodatkowego kodu. Spójny interfejs użytkownika we wszystkich grach skonfigurowanych za pomocą pakietu SDK usług gier w wersji 2. |
Zależności |
Wymaga play-services-auth. |
Moduł gier odpowiada za autoryzację i uwierzytelnianie. Nie musisz dodawać żadnych dodatkowych zależności. |
| Wyloguj się |
Używana strefa czasowa: GoogleSignInClient.signOut. |
Interfejs API wylogowywania nie jest obsługiwany. |
Wiele kont usług gier Play i ustawienia poszczególnych gier |
Zarządzanie kontem jest możliwe w grze. |
Użytkownicy mogą zmienić profil w usługach gier Play w ustawieniach urządzenia mobilnego. Więcej informacji znajdziesz w artykule jak przełączyć profil w Grach Play na urządzeniu mobilnym. |