Usługi gier Google Play, pakiet SDK dla gier w wersji 1, korzystają z funkcji Logowanie przez Google na Androidzie, która jest
wycofana i zostanie usunięta z
pakietu SDK uwierzytelniania Usług Google Play
(com.google.android.gms:play-services-auth) w 2025 roku.
Nowe aplikacje do gier mogą korzystać z pakietu SDK dla gier w wersji 1 do 2025 roku. Usunięcie funkcji Logowania przez Google powoduje problemy z zależnościami w przypadku istniejących aplikacji do gier. Migracja istniejących aplikacji do gier
z pakietu SDK dla gier w wersji 1
do pakietu SDK dla gier w wersji 2
rozwiązuje problemy z zależnościami spowodowane usunięciem funkcji Logowanie przez Google.
Z tego dokumentu dowiesz się, jak aplikacja do gier współdziała z różnymi pakietami SDK. Porównasz też funkcje aplikacji z funkcjami pakietów SDK usług gier Play w wersji 1 i 2.
Interakcje z pakietem SDK
Diagramy ilustrują interakcje między aplikacją do gier na Androidzie, Usługami mobilnymi Google (GMS) Core, usługami Gier Play a serwerem gier innej firmy. Pokazują, jak aplikacja korzysta z usług Google do uwierzytelniania i funkcji gier, a jednocześnie współdziała z oddzielnym systemem innej firmy.
Gry w wersji 2 (obecnie)
Gry w wersji 1 (starsza wersja)
Poniżej znajdziesz krótkie omówienie komponentów i pakietów SDK:
- Aplikacja do gier
- Reprezentuje aplikację do gier użytkownika działającą na urządzeniu z Androidem.
- Składa się z 2 głównych komponentów:
- Pakiet SDK dla gier w wersji 1 lub 2 Pakiet SDK po stronie klienta odpowiedzialny za interakcje z usługami gier Play.
- Pakiet SDK uwierzytelniania Pakiet SDK uwierzytelniania Usług Google Play jest odpowiedzialny 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 definiowania interfejsu Androida (AIDL), co wskazuje na wzorzec komunikacji między różnymi procesami lub usługami.
- Usługi podstawowe GMS, nazywane też Usługami Google Play
- Jest to warstwa zastrzeżona przez Google na Androidzie.
- Aplikacja do gier korzysta z 2 modułów usług podstawowych GMS:
- Moduł gier udostępnia funkcje specyficzne dla gier, takie jak tablice wyników, osiągnięcia i zarządzanie stanem gry.
- Moduł uwierzytelniania Obsługuje operacje uwierzytelniania i autoryzacji użytkowników.
- Pakiety SDK 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 usługami podstawowymi GMS a serwerem usług gier Play.
- Obsługuje żądania interfejsu API, przekształcanie danych i uwierzytelnianie na potrzeby komunikacji z serwerem.
- Serwer usług gier Play
- Reprezentuje usługi backendu usług Gier Play odpowiedzialne za przechowywanie danych z gry, zarządzanie kontami użytkowników i ułatwianie korzystania z funkcji trybu wieloosobowego.
- Brama gier innej firmy
- 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 innej firmy
- Reprezentuje opcjonalny serwer zewnętrzny, z którym aplikacja do gier może współdziałać, prawdopodobnie w celu korzystania z funkcji niestandardowych lub zarządzania danymi.
- Komunikacja z aplikacją odbywa się za pomocą bramy gier innej firmy.
Porównanie funkcji
W tej tabeli znajdziesz porównanie funkcji pakietów SDK dla gier w wersji 1 i 2:
Funkcja |
Pakiet SDK dla gier w wersji 1 |
Pakiet SDK dla gier w wersji 2 |
|---|---|---|
Uwierzytelnianie |
Wymagana jest integracja z play-services-auth. |
Uproszczone i usprawnione; nie wymaga play-services-auth. |
Autoryzacja |
Dodatkowy kod na potrzeby obsługi sukcesów, błędów i ponownych prób. |
Zarządzane przez pakiet SDK. |
Token dostępu do serwera |
Możesz poprosić o dodatkowe zakresy OAuth 2.0 za pomocą GoogleSigninClient.Dodatkowy kod na potrzeby obsługi błędów podczas uwierzytelniania. |
Podczas żądania dostępu po stronie serwera do interfejsów API usług gier Play możesz poprosić o 3 podstawowe zakresy tożsamości OAuth 2.0 za pomocą GamesSignInClient.
Więcej informacji znajdziesz w artykułach Dostęp po stronie serwera do usług gier Play i Pobieranie kodów uwierzytelniania serwera. |
Proces logowania |
Korzysta z GoogleSigninClient.Dodatkowy kod na potrzeby obsługi powtarzalnego kodu na potrzeby automatycznego uwierzytelniania i obsługi błędów. |
Korzysta z GamesSignInClient.Pakiet SDK obsługuje powtarzalny kod, automatyczne uwierzytelnianie i obsługę błędów. |
Wyskakujące okienko powitalne |
Wymagany jest dodatkowy kod. Deweloperzy mogą kontrolować jego umiejscowienie i czas wyświetlania. |
Nie jest wymagany dodatkowy kod. Spójny interfejs użytkownika we wszystkich grach skonfigurowanych za pomocą pakietu SDK dla gier w wersji 2. |
Zależności |
Wymaga play-services-auth. |
Moduł gier zajmuje się autoryzacją i uwierzytelnianiem. Nie musisz dodawać żadnych dodatkowych zależności. |
| Wylogowanie |
Korzysta z GoogleSignInClient.signOut. |
Interfejs API wylogowania nie jest obsługiwany. |
Wiele kont usług gier Play i ustawienia poszczególnych gier |
Zarządzanie kontami jest możliwe w grze. |
Użytkownicy mogą zmienić profil usług gier Play w ustawieniach urządzenia mobilnego. Więcej informacji znajdziesz w artykule Jak przełączyć profil w Grach Play na urządzeniu mobilnym. |