Konfigurowanie Usług gier Google Play w Unity i logowanie się

Prześlij opinię

W tym dokumencie znajdziesz instrukcje konfigurowania projektu w Unity pod kątem korzystania z wtyczki Gier Google Play do Unity. Dowiesz się, jak zainstalować wtyczkę i skonfigurować projekt w Unity. Opisano w nim też, jak zweryfikować usługę logowania.

Zanim zaczniesz

Sprawdź wymagania dotyczące oprogramowania. Skonfiguruj Konsolę Play i zainstaluj Unity Hub.

• Skonfiguruj Konsolę Play dla swojej gry.

• Zainstaluj Unity Hub i stwórz grę w Unity.

Instalacja wtyczki

Aby pobrać i zainstalować wtyczkę Gry Google Play do Unity, wykonaj te czynności w Unity Hub:

1. Pobierz repozytorium GitHub.

2. W katalogu current-build znajdź plik unitypackage. Ten plik reprezentuje wtyczkę. Powinien on wyglądać podobnie do tego:

     current-build/GooglePlayGamesPluginForUnity-X.YY.ZZ.unitypackage
   

Konfigurowanie projektu Unity

Aby skonfigurować projekt Unity w ustawieniach odtwarzacza, wykonaj te czynności:

1. Otwórz projekt gry.

2. W Unity Hub kliknij Assets > Import Package > Custom Package (Zasoby > Importuj pakiet > Własny pakiet), aby zaimportować plik unitypackage do zasobów projektu.

3. Sprawdź, czy bieżąca platforma kompilacji jest ustawiona na Android.

   1. W menu głównym kliknij Plik > Ustawienia kompilacji.

   2. Wybierz Android i kliknij Przełącz platformę.

   3. W menu Okno > Gry Google Play powinna pojawić się nowa pozycja. Jeśli nie, odśwież zasoby, klikając Zasoby > Odśwież, a następnie spróbuj ponownie ustawić platformę kompilacji.

4. W Unity Hub kliknij File > Build Settings > Player Settings > Other Settings (Plik > Ustawienia kompilacji > Ustawienia odtwarzacza > Inne ustawienia).

5. W polu Docelowy poziom API wybierz wersję.

6. W polu Backend skryptów wpisz IL2CPP.

7. W polu Architektury docelowe wybierz wartość.

8. Zanotuj nazwę pakietu package_name.Te informacje możesz wykorzystać później.

Tworzenie nowego magazynu kluczy

Aby potwierdzić swoje uprawnienia, potrzebujesz klucza. Wykonaj te czynności:

1. W Unity Hub kliknij File (Plik) > Build settings (Ustawienia kompilacji) > Player settings (Ustawienia odtwarzacza).
2. W sekcji Ustawienia publikowania kliknij Menedżer kluczy.
   1. W oknie Menedżer magazynu kluczy kliknij Magazyn kluczy > Utwórz nowy > W dowolnym miejscu.
   2. Wybierz folder i podaj nazwę magazynu kluczy.
   3. W polu Hasło wpisz hasło i potwierdź je.
   4. Kliknij Dodaj klucz.

Zanotuj nazwę folderu. Możesz użyć tej nazwy, aby utworzyć dane logowania w Google Cloud.

Kopiowanie zasobów Androida z Konsoli Play

Każde osiągnięcie, tabela wyników i wydarzenie utworzone w Konsoli Play zawiera zasób Androida, którego używasz podczas konfigurowania projektu Unity.

Aby uzyskać zasoby Androida dla swojej gry, wykonaj te czynności:

1. W Konsoli Google Play otwórz grę.

2. Na stronie Usługi gier Play – konfiguracja (Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Konfiguracja) kliknij Pobierz zasoby.

3. W oknie Zasoby kliknij kartę Android(XML).

4. Wybierz i skopiuj zawartość zasobów Androida (AndroidManifest.xml).

Dodawanie zasobów Androida do projektu Unity

Dodaj do projektu w Unity te zasoby Androida:

1. W Unity Hub kliknij Window > Google Play Games > Setup > Android Setup (Okno > Gry Google Play > Konfiguracja > Konfiguracja Androida).

   • W polu Katalog do zapisywania stałych wpisz nazwę folderu, w którym ma być zapisany plik stałych.

   • W polu Nazwa klasy stałych wpisz nazwę klasy C# do utworzenia, w tym przestrzeń nazw.

     Jeśli na przykład klasa C# to id.cs i znajduje się w folderze Assets > myproject > scripts > id.cs. Nazwa klasy stałych może mieć wartość myproject.scripts.id.

   • W polu Definicja zasobów wklej dane zasobów Androida (plik AndroidManifest.xml) skopiowane z Konsoli Google Play.

   • Opcjonalnie: w polu Identyfikator klienta wpisz identyfikator klienta połączonej aplikacji internetowej.

     Informacje o tym, jak uzyskać identyfikator klienta gry w Google Cloud, znajdziesz w sekcji Tworzenie identyfikatorów klientów.

     Jest to potrzebne tylko wtedy, gdy Twoja gra ma backend internetowy i potrzebujesz kodu autoryzacji serwera, aby wymienić go na token dostępu na serwerze backendu, lub gdy potrzebujesz tokena identyfikatora gracza, aby wykonywać inne wywołania interfejsu API niezwiązane z grą.

   • Kliknij Konfiguruj. Spowoduje to skonfigurowanie gry za pomocą identyfikatora klienta i wygenerowanie klasy C#, która zawiera stałe dla każdego z zasobów Androida.

2. W Unity Hub kliknij Window > Google Play Games > Setup > Nearby Connections Setup (Okno > Gry Google Play > Konfiguracja > Konfiguracja połączeń w pobliżu).

   • W polu Identyfikator usługi połączenia w pobliżu wpisz package_name.

     Użyj tego samego package_name, którego użyto podczas konfigurowania projektu Unity.

   • Kliknij Konfiguruj.

Wybierz platformę społecznościową

Wtyczka Usług gier Google Play implementuje interfejs społecznościowy Unity, aby zapewnić zgodność z grami, które już korzystają z tego interfejsu podczas integracji z innymi platformami. Niektóre funkcje są jednak dostępne tylko w Grach Play i stanowią rozszerzenie standardowego interfejsu społecznościowego udostępnianego przez Unity.

Do standardowych wywołań interfejsu API można uzyskać dostęp za pomocą obiektu Social.Active, który jest odwołaniem do interfejsu ISocialPlatform. Do niestandardowych rozszerzeń usług gier Google Play można uzyskać dostęp, rzutując obiekt Social.Active na klasę PlayGamesPlatform, w której dostępne są dodatkowe metody.

Korzystanie z wtyczki bez zastępowania domyślnej platformy społecznościowej

Gdy wywołasz PlayGamesPlatform.Activate, usługi gier Google Play staną się domyślną implementacją platformy społecznościowej, co oznacza, że statyczne wywołania metod w Social i Social.Active będą wykonywane przez wtyczkę usług gier Google Play. Tak działa większość gier korzystających z tej wtyczki.

Jeśli jednak z jakiegoś powodu chcesz zachować dostęp do domyślnej implementacji (np. aby używać jej do przesyłania osiągnięć i tablic wyników na inną platformę społecznościową), możesz użyć wtyczki Usług Google Play w Grach bez zastępowania domyślnej implementacji. Aby to zrobić:

1. Nie dzwoń PlayGamesPlatform.Activate
2. Jeśli Xyz to nazwa metody, którą musisz wywołać w klasie Social, nie wywołuj Social.Xyz. Zamiast tego zadzwoń pod numer PlayGamesPlatform.Instance.Xyz
3. Nie używaj Social.Active podczas korzystania z Usług gier Play. Zamiast tego użyj interfejsu PlayGamesPlatform.Instance.

Dzięki temu możesz przesyłać wyniki i osiągnięcia jednocześnie na 2 lub więcej platform społecznościowych:

    // Submit achievement to original default social platform
    Social.ReportProgress("MyAchievementIdHere", 100.0f, callback);

    // Submit achievement to Google Play
    PlayGamesPlatform.Instance.ReportProgress("MyGooglePlayAchievementIdHere", 100.0f, callback);

Weryfikowanie usługi logowania

Po otwarciu gry automatycznie podejmowana jest próba połączenia z usługami gier Play za pomocą usługi logowania. Jeśli połączenie się powiedzie, w grze pojawi się prośba o zalogowanie, a Ty będziesz mieć możliwość korzystania z wtyczki usług gier Google Play do silnika Unity.

Jeśli użytkownik nigdy nie korzystał na urządzeniu z usług gier Google Play, automatycznie wyświetli mu się ekran jednorazowej konfiguracji, na którym może utworzyć konto w Grach Play.

W metodzie Start skryptu nasłuchuj wyniku automatycznej próby logowania, pobierz stan uwierzytelniania i wyłącz funkcje Usług gier Play, jeśli użytkownik nie jest zalogowany.

Jeśli wersja wtyczki Unity jest starsza niż v11, nie możesz korzystać z funkcji logowania.

    using GooglePlayGames;

    public void Start() {
      PlayGamesPlatform.Instance.Authenticate(ProcessAuthentication);
    }

    internal void ProcessAuthentication(SignInStatus status) {
      if (status == SignInStatus.Success) {
        // Continue with Play Games Services
      } else {
        // Disable your integration with Play Games Services or show a login button
        // to ask users to sign-in. Clicking it should call
        // PlayGamesPlatform.Instance.ManuallyAuthenticate(ProcessAuthentication).
      }
    }

Kod wyniku to wyliczenie, którego możesz użyć do określenia przyczyny niepowodzenia logowania.

Jeśli wolisz korzystać z platformy społecznościowej Unity, możesz użyć tego kodu:

  using GooglePlayGames;

  public void Start() {
    PlayGamesPlatform.Activate();
    Social.localUser.Authenticate(ProcessAuthentication);
  }

Nie możesz wykonywać żadnych wywołań interfejsu API usług gier Google Play, dopóki nie uzyskasz prawidłowej wartości zwracanej z funkcji Authenticate. Dlatego zalecamy, aby gry wyświetlały ekran gotowości, dopóki nie zostanie wywołane wywołanie zwrotne. Dzięki temu użytkownicy nie będą mogli rozpocząć gry, dopóki nie zostanie zakończona autoryzacja.

Używanie podpisywania aplikacji przez Google Play

Google zarządza kluczem podpisywania Twojej aplikacji i zabezpiecza go za pomocą podpisywania aplikacji przez Google Play. Podpisywanie aplikacji przez Google Play umożliwia podpisywanie zoptymalizowanych plików pakietów Android App Bundle na potrzeby dystrybucji. Usługa podpisywania aplikacji przez Google Play przechowuje Twój klucz podpisywania aplikacji w bezpiecznej infrastrukturze Google. Aby korzystać z podpisywania aplikacji przez Google Play, musisz najpierw utworzyć i pobrać plik AAB z Unity Hub. Następnie możesz przesłać plik AAB do Konsoli Play i utworzyć wersję testu wewnętrznego.

Tworzenie pliku AAB

Aby utworzyć plik AAB w Unity Hub:

1. W Unity Hub kliknij File > Build settings (Plik > Ustawienia kompilacji).

2. Wybierz Build App Bundle ( Google Play ) (Utwórz pakiet aplikacji (Google Play)).

   Więcej informacji znajdziesz w dokumentacji ustawień kompilacji na Androida.

3. Kliknij Build (Kompilacja).

4. Pobierz plik AAB z Unity Hub.

Tworzenie wersji do testów wewnętrznych

Aby utworzyć wewnętrzną wersję testową i dodać testerów w Konsoli Play, wykonaj te czynności:

1. W Konsoli Google Play wybierz grę.
2. Otwórz stronę Testowanie i wdrażanie (Testowanie> Test wewnętrzny).
3. Kliknij Prześlij i wybierz plik AAB.
4. W polu Szczegóły wersji wpisz nazwę.
5. Kliknij Dalej i sprawdź szczegóły wydania.
6. Kliknij Zapisz i opublikuj.

7. Na karcie Testerzy kliknij Utwórz listę e-mailową, aby dodać maksymalnie 100 testerów.

   Więcej informacji znajdziesz w artykule Test wewnętrzny: zarządzanie maksymalnie 100 testerami.

8. W polu URL lub adres e-mail do przesyłania opinii wpisz URL lub adres e-mail, na który można przesyłać opinie.

9. Kliknij Zapisz.

Weryfikowanie danych logowania do podpisywania aplikacji

1. W Konsoli Google Play wybierz grę.
2. Otwórz stronę Testuj i publikuj (Konfiguracja> Podpisywanie aplikacji).
3. Sprawdź dane logowania do podpisywania aplikacji.

Kompilowanie i uruchamianie projektu

W tym momencie możesz skompilować i uruchomić projekt gry. Gdy gra się uruchomi, zobaczysz automatyczną próbę zalogowania.

Potrzebujesz fizycznego urządzenia z Androidem z włączonym debugowaniem USB lub emulatora, na którym można uruchomić opracowany projekt.

Pobieranie kodów uwierzytelniania serwera

Aby uzyskać dostęp do interfejsów API Google na serwerze backendu w imieniu bieżącego gracza, musisz pobrać kod uwierzytelniania z aplikacji klienta i przekazać go do aplikacji serwera internetowego. Kod można następnie wymienić na token dostępu, aby wywoływać różne interfejsy API. Informacje o procesie znajdziesz w artykule Logowanie się za pomocą Google w internecie.

Aby uzyskać kod dostępu po stronie serwera:

1. Dodaj identyfikator klienta internetowego do swojej gry w Konsoli Play.
   1. W Konsoli Google Play wybierz grę.
   2. Na stronie Konfiguracja (Zwiększaj liczbę użytkowników > Usługi gier Play > Konfiguracja i zarządzanie > Konfiguracja) kliknij Dodaj dane logowania.
   3. Na stronie Dodaj dane logowania kliknij Serwer gier.
   4. Wygeneruj identyfikator klienta OAuth 2.0.
   5. Zapisz wartość identyfikatora klienta. Tę wartość musisz podać później.

2. Dodaj identyfikator klienta internetowego do Unity Hub.

   1. W centrum Unity skonfiguruj Gry Google Play na Unity i zaloguj się.
   2. W centrum Unity kliknij Window > Google Play Games > Setup > Android Setup (Okno > Usługi gier Play > Konfiguracja > Konfiguracja Androida).
   3. Wpisz wartość identyfikatora klienta.

3. Pobierz kod autoryzacji serwera dla dodatkowych zakresów.

   C#

   using GooglePlayGames.BasicApi;
   
   // Define selectedScope having additional identity scopes.
   private List selectedScopes = new List();
   
   // Add scopes you want to request.
   selectedScopes.Add(AuthScope.OPEN_ID);
   selectedScopes.Add(AuthScope.PROFILE);
   selectedScopes.Add(AuthScope.EMAIL);
   
   // Call RequestServerSideAccess with additional scopes and retrieve
   // authcode and grantedscopes list.
   PlayGamesPlatform.Instance.RequestServerSideAccess(
       /* forceRefreshToken= */ false,selectedScopes
       (AuthResponse authResponse) =>
       {
       string authCode = authResponse.GetAuthCode();
       List grantedScopes = authResponse.GetGrantedScopes();
   
       // send authCode to server...
   });

Konfigurowanie i dodawanie funkcji

• Włącz funkcje usług gier Play.

• Dodaj do gry funkcje przy użyciu interfejsów API usług gier Play:

  • Osiągnięcia

  • Tabele wyników

  • Ze znajomymi

  • Zapisywanie gier

  • Statystyki zawodnika

  • Wydarzenia

• Recall API for Unity (obsługiwany tylko w przypadku wtyczki Unity w wersji 11 lub nowszej)