Usługi gier Google Play, pakiet SDK gier w wersji 1 korzysta z logowania Google na Androida, które jest wycofane i zostanie usunięte z pakietu SDK usług Google Play do uwierzytelniania (com.google.android.gms:play-services-auth) w 2025 roku.
Nowe aplikacje gier mogą korzystać z wersji 1 do 2025 roku. Usunięcie Logowania przez Google powoduje problemy z zależnością w przypadku istniejących aplikacji gier. Migracja dotychczasowych gier z pakietu SDK gier w wersji 1 do pakietu SDK gier w wersji 2 rozwiązuje problemy z zależnościami spowodowane usunięciem funkcji logowania w Google.
Z tego dokumentu dowiesz się, jak aplikacja gier współdziała z różnymi pakietami SDK. Dokument ten zawiera też porównanie funkcji 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ą gier na Androida, usługami podstawowymi Google Mobile Services (GMS), usługami gier Google Play oraz serwerem gier zewnętrznego dostawcy. Pokazuje, jak aplikacja korzysta z usług Google do uwierzytelniania i funkcji gry, a także jak wchodzi w interakcję z osobnym systemem innej firmy.
gry v2 (obecna),
gry w wersji 1 (starsza wersja),
Poniżej znajdziesz krótkie omówienie komponentów i pakietów SDK:
- Aplikacja Gry
- Reprezentuje aplikację do gier użytkownika działającą na urządzeniu z Androidem.
- Składa się z 2 głównych elementów:
- pakiet SDK usług gier Google Play w wersji 1 lub 2 Pakiet SDK po stronie klienta odpowiedzialny za interakcje z usługami Play Games.
- Pakiet Auth SDK Pakiet Google Play Services Auth SDK odpowiada za obsługę procesów uwierzytelniania i autoryzacji użytkowników w wersji 1 gier.
- Oba pakiety SDK komunikują się za pomocą języka AIDL (Android Interface Definition Language), który określa wzór komunikacji między różnymi procesami lub usługami.
- GMS Core, czyli Usługi Google Play
- Jest to warstwa własna Google na Androidzie.
- Aplikacja do gier korzysta z 2 modułów GMS Core:
- Moduł Gry: zawiera funkcje związane z poszczególnymi 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 usług gier i uwierzytelniania w aplikacji do gier komunikują się z odpowiednimi modułami za pomocą interfejsów AIDL, co wskazuje na komunikację między procesami (IPC).
- Brama usług gier Play
- Brama logiczna, 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 ramach komunikacji z serwerem.
- Serwer usług gier Play.
- Reprezentuje usługi backendowe usług gier Play odpowiedzialne za przechowywanie danych gry, zarządzanie kontami użytkowników i ułatwianie funkcji wieloosobowych.
- Brama do gier innych firm
- Jeśli Twoja aplikacja z grami 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 się uwierzytelnić u innego dostawcy usług.
- Serwer gier firmy zewnętrznej.
- Reprezentuje opcjonalny zewnętrzny serwer, z którym aplikacja gier może wchodzić w interakcje, prawdopodobnie w celu obsługi funkcji niestandardowych lub zarządzania danymi.
- Komunikacja z aplikacją odbywa się przez bramkę gier innej firmy.
Porównanie funkcji
Tabela porównująca funkcje pakietów SDK gier w wersji 1 i 2:
Funkcja |
Pakiet SDK Google Play Games w wersji 1 |
Pakiet SDK wersji 2 dla gier |
|---|---|---|
Uwierzytelnianie |
Wymagana integracja z play-services-auth. |
Uproszczone i wygodne, nie wymagają play-services-auth. |
Autoryzacja |
Dodatkowy kod powodzenia, niepowodzenia i powtórnych 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. |
Dodatkowe zakresy są niedozwolone. Dodatkowy kod z wywołaniem zwrotnym success failure z serverAuthcode. |
Proces logowania |
Używa GoogleSigninClient.Dodatkowy kod do obsługi szablonu kodu do automatycznego logowania i obsługi błędów. |
Używa GamesSignInClient.Pakiet SDK obsługuje powtarzalny kod, logowanie automatyczne i obsługę błędów. |
Wyskakujące okienko powitalne |
Wymagane dodatkowe kodowanie. Deweloperzy mogą kontrolować jego umiejscowienie i czas wyświetlania. |
Nie wymaga dodatkowego kodu. Spójny interfejs użytkownika we wszystkich grach skonfigurowanych z użyciem PGS V2. . |
Zależności |
Wymaga play-services-auth. |
Brak osobnej zależności od play-services-auth. |
| Wylogowanie |
Używa GoogleSignInClient.signOut. |
Interfejs API wylogowywania nie jest obsługiwany. |
Wiele kont usług gier Play i ustawień na poszczególne gry |
Wybieranie kont i zarządzanie nimi jest niedostępne. |
W przypadku każdej gry możesz zarządzać swoim kontem Usług Gier Play. Dzięki temu możesz wybrać konto, którego używać ma dana gra. |