Konfigurowanie usług gier Google Play

Z tego artykułu dowiesz się, jak skonfigurować usługi gier Google Play w grze na Androida za pomocą Konsoli Google Play. Konsola Play to centralne miejsce, w którym możesz zarządzać usługami gier i konfigurować metadane używane do autoryzacji i uwierzytelniania gry.

Aby dodać grę do Konsoli Play, wykonaj te ogólne czynności:

  • Utwórz projekt gry i określ szczegóły, takie jak nazwa i opis gry.

  • Utwórz i połącz niezbędne dane logowania, aby autoryzować i uwierzytelniać grę w usługach gier Play.

Zanim rozpoczniesz

Zanim skonfigurujesz usługi gier Play, wykonaj te czynności.

Tworzenie konta dewelopera w Google Play

Tworzenie projektu Google Cloud

Musisz mieć skonfigurowany projekt Google Cloud. Więcej informacji znajdziesz w artykule

Aby korzystać z Konsoli Play, musisz włączyć interfejsy API, których planujesz używać w projekcie.

Konsola

Włącz interfejs Google Play Game Services API

gcloud 

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

Logowanie w Konsoli Play

Aby się zalogować, otwórz Konsolę Google Play. Jeśli nie masz jeszcze konta w Konsoli Play, pojawi się prośba o zarejestrowanie się.

Dodawanie gry do Konsoli Play

Aby dodać grę, wykonaj te czynności:

  1. W Konsoli Play utwórz aplikację i określ, że jest to gra. Więcej informacji znajdziesz w artykule Tworzenie i konfigurowanie aplikacji.

  2. Kliknij Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Konfiguracja.

  3. Określ, czy w swojej grze używasz już interfejsów API Google (np. Firebase). Wybierz właściwą opcję, ponieważ w przeciwnym razie Twoja gra może mieć problemy z korzystaniem z interfejsów API Google. Dostępne opcje:

    • Nie, w swojej grze nie używam interfejsów API Google: wybierz tę opcję, jeśli tworzysz nową grę lub nigdy nie konfigurowałeś w niej interfejsu API Google. Wpisz nazwę gry i kliknij Utwórz.

    • Tak, w swojej grze używam już interfejsów API Google: wybierz tę opcję, jeśli masz już skonfigurowany interfejs API Google dla gry. W takim przypadku zobaczysz listę projektów z Google Cloud Console. Wybierz projekt z listy, a następnie kliknij Użyj.

    • Użyj istniejącego projektu usług gier Play: jeśli chcesz użyć istniejącego projektu usług gier Play, wybierz tę opcję. Zobaczysz listę istniejących projektów usług gier Play na Twoim koncie. Wybierz z listy projekt gry, a potem kliknij Użyj. Nie jest to typowy wybór, ale możesz to zrobić, jeśli tworzysz nową grę w Konsoli Play, aby zmienić nazwę pakietu, lub jeśli masz bezpłatną i płatną wersję gry z różnymi nazwami pakietów.

    Zostanie utworzony projekt gry w usługach gier Play i odpowiedni wpis w Google Cloud Console.

  4. W sekcji Właściwości kliknij Edytuj właściwości, aby dodać informacje, takie jak opis, kategoria i zasoby graficzne gry. Oto kilka wskazówek dotyczących konfigurowania właściwości:

Generowanie identyfikatora klienta OAuth 2.0

Aby można było uwierzytelnić Twoją grę i przyznać jej uprawnienia do wywoływania usług gier Play, musi ona mieć identyfikator klienta OAuth 2.0. Aby skonfigurować dane logowania do Usług gier Play, czyli powiązanie między identyfikatorem klienta a Twoją grą, utwórz identyfikator klienta w Google Cloud Platform. Następnie użyj Konsoli Google Play, aby dodać dane logowania, łącząc identyfikator klienta z grą.

Szczegółowe instrukcje znajdziesz poniżej:

Jeśli nie masz jeszcze skonfigurowanego ekranu zgody OAuth, w sekcji Dane logowania pojawi się komunikat z prośbą o skonfigurowanie.

Prośba o skonfigurowanie ekranu zgody OAuth

Kliknij Skonfiguruj. Otworzy się okno dialogowe z dalszymi instrukcjami i linkiem do Google Cloud Platform.

Wyświetlanie prośby o skonfigurowanie ekranu zgody OAuth.

Upewnij się, że ekran zgody jest dostępny dla wszystkich użytkowników, którzy mogą korzystać z gry. Ostateczna lista zakresów musi zawierać games, games_lite i drive.appdata. Żaden z tych zakresów nie będzie wymagać weryfikacji aplikacji. Zalecamy natychmiastowe opublikowanie ekranu zgody. Jeśli to niemożliwe, możesz udostępnić ekran zgody testerom, aby umożliwić im uwierzytelnianie w grze.

Jeśli konfiguracja ekranu zgody OAuth została zakończona, kliknij Gotowe. Konsola Play odświeża się automatycznie. Jeśli konfiguracja się powiodła, możesz utworzyć dane logowania:

Tworzenie danych logowania

Tworzenie danych logowania

Aby autoryzować grę do komunikowania się z usługami gier Play, musisz utworzyć dane logowania z autoryzowanym identyfikatorem klienta OAuth2.

W sekcji Dane logowania kliknij Dodaj dane logowania.

W kreatorze wybierz, czy chcesz utworzyć dane logowania Androida (jeśli plik APK gry będzie uwierzytelniać użytkownika i korzystać z interfejsów API usług gier Play) czy dane logowania serwera gier (jeśli serwer gier będzie korzystać z interfejsów API usług gier Play). Postępuj zgodnie z instrukcjami dotyczącymi wybranego typu dokumentu.

Android

Konfigurowanie szczegółów danych logowania

Sprawdź, czy nazwa w polu Nazwa jest zgodna z nazwą Twojej gry. Wybierz, czy chcesz włączyć zabezpieczenia antypirackie.

Konfigurowanie autoryzacji

Następnie wybierz identyfikator klienta OAuth, który ma być używany w tym projekcie gry. Jeśli masz już identyfikatory klienta OAuth2, możesz wybrać jeden z nich. Zwykle jednak tworzysz nowy. Kliknij Utwórz klienta OAuth. Otworzy się okno z linkami bezpośrednimi i instrukcjami tworzenia identyfikatora klienta OAuth w Google Cloud Platform.

  1. Jako typ aplikacji wybierz Android.
  2. W polu Nazwa wpisz nazwę gry.
  3. W polu Nazwa pakietu wpisz nazwę pakietu aplikacji na Androida.

  4. Otwórz terminal i uruchom narzędzie Keytool, aby pobrać odciski cyfrowe SHA1 certyfikatów wersji i debugowania.

    Aby uzyskać odcisk cyfrowy certyfikatu wersji, uruchom to polecenie:

    keytool -list -keystore <path-to-production-keystore> -v

    Aby uzyskać odcisk cyfrowy certyfikatu debugowania, uruchom to polecenie:

    keytool -list -keystore <path-to-debug-keystore> -v Uwaga: w systemie Windows magazyn kluczy debugowania znajduje się w C:\Users\<USERNAME>\.android\debug.keystore. W systemie Mac lub Linux magazyn kluczy debugowania zwykle znajduje się w lokalizacji ~/.android/debug.keystore.

  5. Opcjonalnie: jeśli utworzono nowy magazyn kluczy za pomocą Unity Hub, nie twórz nowego certyfikatu zgodnie z instrukcjami z poprzedniego kroku. Użyj odcisku palca SHA1 utworzonego w Unity.

    • Aby wydrukować odcisk SHA1 w terminalu, użyj tego polecenia:

      keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v

  6. Narzędzie keytool poprosi Cię o podanie hasła do magazynu kluczy. Narzędzie Keytool przesyła odcisk cyfrowy do terminala.

  7. Wklej odcisk cyfrowy SHA1 w polu Odcisk cyfrowy certyfikatu podpisującego (SHA1).

  8. Kliknij Utwórz.

Więcej informacji o OAuth 2.0 na Androidzie znajdziesz w artykule Uwierzytelnianie w usługach OAuth2.

Gdy w oknie klikniesz Gotowe, lista dostępnych identyfikatorów klienta odświeży się. Wybierz utworzone dane logowania z menu, a następnie kliknij Zapisz zmiany. Spowoduje to utworzenie danych logowania w wersji roboczej, co umożliwi Ci uwierzytelnianie w usługach gier Play w Twojej grze.

Możesz utworzyć 2 rodzaje danych logowania: jeden z odciskiem cyfrowym certyfikatu wersji, a drugi z odciskiem cyfrowym certyfikatu debugowania. Pamiętaj, aby w obu przypadkach używać tej samej nazwy pakietu. Dzięki temu usługi gier Google Play mogą rozpoznawać wywołania z połączonych plików APK podpisanych dowolnym certyfikatem. Więcej informacji o podpisywaniu certyfikatów na Androidzie znajdziesz w artykule Podpisywanie aplikacji.

Serwer gry

Konfigurowanie szczegółów danych logowania

Sprawdź, czy nazwa w polu Nazwa jest zgodna z nazwą Twojej gry.

Konfigurowanie autoryzacji

Następnie wybierz identyfikator klienta OAuth, który ma być używany w tym projekcie gry. Jeśli masz już identyfikatory klienta OAuth2, możesz wybrać jeden z nich. Zwykle jednak tworzysz nowy. Kliknij Utwórz klienta OAuth. Otworzy się okno z linkami bezpośrednimi i instrukcjami tworzenia identyfikatora klienta OAuth w Google Cloud Platform.

  1. Jako typ aplikacji wybierz Aplikacja internetowa.
  2. W polu Nazwa wpisz nazwę gry.
  3. Kliknij Utwórz.

Więcej informacji o OAuth 2.0 na Androidzie znajdziesz w artykule Uwierzytelnianie w usługach OAuth2.

Gdy w oknie klikniesz Gotowe, lista dostępnych identyfikatorów klienta odświeży się. Wybierz utworzone dane logowania z menu, a następnie kliknij Zapisz zmiany. Spowoduje to utworzenie danych logowania w wersji roboczej, co umożliwi Ci uwierzytelnianie w usługach gier Play z serwera gry. Więcej informacji o korzystaniu z Usług gier Play na serwerze gry znajdziesz w artykule Włączanie dostępu po stronie serwera do Usług gier Google Play.

Włączanie testowania

Aby sprawdzić, czy usługi gier Google Play działają w Twojej grze prawidłowo, przetestuj je przed opublikowaniem zmian w grze w Google Play.

Jeśli gra nie została jeszcze opublikowana, przyznaj testerom dostęp, dodając ich konta użytkowników do listy dozwolonych. W przeciwnym razie testerzy będą napotykać błędy OAuth i 404 podczas próby uzyskania dostępu do punktów końcowych usług gier Play, takich jak punkt końcowy uwierzytelniania platformy.

Użytkownicy z autoryzowanymi kontami testowymi będą mieć dostęp do nieopublikowanego projektu gry w usługach gier Play i będą mogli sprawdzić, czy skonfigurowane usługi gier Play działają prawidłowo.

Testerom możesz umożliwić korzystanie z interfejsów API usług gier Play w przypadku Twojej gry na 2 sposoby:

  • na poziomie indywidualnym, dodając poszczególne adresy e-mail;

  • Na poziomie grupy przez włączenie usług gier Play na ścieżce publikowania w Konsoli Play.

Aby dodać poszczególnych testerów do projektu gry:

  1. Otwórz kartę Testerzy w Konsoli Google Play (Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Testerzy).
  2. Kliknij przycisk Dodaj testerów.
  3. W wyświetlonym oknie wpisz adresy e-mail kont Google, które chcesz dodać jako testerów (oddzielone przecinkami lub po jednym adresie e-mail w wierszu).
  4. Kliknij Dodaj, aby zapisać użytkowników jako testerów. Konta testerów, które zostały dodane, powinny uzyskać dostęp do usług gier Play w ciągu kilku godzin.

Aby przyznać grupie dostęp do testowania, włącz dostęp do usług gier Play na ścieżce wersji:

Google Play ułatwia rozpowszechnianie przedpremierowych wersji aplikacji w kontrolowanych grupach zaufanych użytkowników dzięki funkcjom ścieżki wersji. Więcej informacji znajdziesz w artykule Przygotowywanie testu otwartego, zamkniętego lub wewnętrznego w Centrum pomocy Google Play.

Możesz przyznać dostęp do testowania gry wszystkim użytkownikom, którzy mają dostęp do testowych plików APK na danej ścieżce wersji. Działa to tak samo, jak gdybyś dodał(-a) je do listy testerów pojedynczo. W tym celu należy wykonać następujące czynności:

  1. Otwórz sekcję Testerzy usług gier Play (Rozwój> Usługi gier Play> Konfiguracja i zarządzanie> Testerzy) i kliknij kartę Ścieżki wersji. Na tej stronie możesz też zobaczyć listę ścieżek, które są już włączone do testowania usług gier Play.
  2. Kliknij Dodaj ścieżki.
  3. Wybierz co najmniej jeden ścieżkę, którą chcesz włączyć do testowania usług gier Play.
  4. Kliknij Dodaj ścieżki.

Wybrane ścieżki wersji pojawią się teraz na liście ścieżek włączonych do testowania usług gier Play.

Ta funkcja jest dostępna tylko wtedy, gdy masz aplikację na Androida połączoną z grą w Konsoli Google Play.

Unikanie typowych problemów

Aby uniknąć typowych błędów konfiguracji, podczas konfigurowania gry do korzystania z usług gier Play postępuj zgodnie z tymi zaleceniami.

1. Konfigurowanie gry w Konsoli Play
Jeśli identyfikator klienta OAuth 2.0 został utworzony w konsoli Google Cloud, usługi gier Play nie będą znać powiązania między osiągnięciami i tablicami wyników w grze a identyfikatorem klienta. Aby utworzyć to powiązanie, musisz utworzyć dane logowania za pomocą identyfikatora klienta OAuth 2.0 zgodnie z opisem w sekcji Tworzenie danych logowania.
2. Używanie prawidłowego identyfikatora aplikacji na Androidzie
Identyfikator aplikacji to wymagany zasób w postaci ciągu znaków, do którego musisz się odwołać w manifeście Androida. Ciąg znaków identyfikatora aplikacji składa się tylko z cyfr (zwykle co najmniej 12) na początku identyfikatora klienta podanego przez Konsolę Play. Identyfikator aplikacji znajdziesz u góry strony Konfiguracja. Jest on oznaczony jako Identyfikator projektu pod nazwą gry.
3. Podpisz plik APK odpowiednim certyfikatem.
Podczas łączenia aplikacji na Androida z grą w Konsoli Play musisz użyć dokładnie tej samej nazwy pakietu i odcisku palca certyfikatu, których użyto do opublikowania aplikacji. Jeśli wystąpi niezgodność, wywołania usług gier Google Play zakończą się niepowodzeniem. Utwórz 2 identyfikatory klienta: jeden z odciskiem cyfrowym certyfikatu wersji, a drugi z odciskiem cyfrowym certyfikatu debugowania. W obu przypadkach użyj tej samej nazwy pakietu. Więcej informacji o tym, jak określić certyfikat podpisywania w Konsoli Play, znajdziesz w artykule Podpisywanie aplikacji.
4. Podczas tworzenia aplikacji na Androida uwzględnij pakiet SDK do gier Play jako projekt biblioteki, a nie jako samodzielny plik JAR.
Upewnij się, że pakiet SDK Usług Google Play jest w projekcie na Androida traktowany jako projekt biblioteki. W przeciwnym razie może to prowadzić do błędów, gdy aplikacja nie będzie w stanie znaleźć zasobów Usług Google Play. Aby dowiedzieć się, jak skonfigurować projekt na Androida do korzystania z Usług Google Play, przeczytaj artykuł Konfigurowanie Usług Google Play.
5. Logowanie się na konto testera podczas tworzenia aplikacji
Jeśli nie opublikujesz zmian ustawień gry w Konsoli Play, podczas testowania możesz napotkać błędy, jeśli nie zalogujesz się na konto testera z białej listy. Konto wydawcy w Konsoli Play zawsze powinno być włączone do testowania. Aby dowiedzieć się, jak zarządzać kontami testerów, przeczytaj artykuł Włączanie kont do testowania.
6. Publikowanie ekranu zgody w Google Cloud Platform
Przed opublikowaniem aplikacji w Konsoli Play opublikuj ekran zgody w Google Cloud Platform. Bez tego kroku publiczna grupa odbiorców nie będzie mogła korzystać z żadnych funkcji usług gier Play.
7. Przed opublikowaniem gry opublikuj najpierw ustawienia usług gier Play.
Deweloperzy mogą przypadkowo opublikować aplikację bez opublikowania odpowiednich ustawień usług gier Play. Może to powodować błędy u graczy, którzy uwierzytelniają się za pomocą kont innych niż konta testerów, ponieważ aplikacja nie może odwoływać się do prawidłowych ustawień gry. Pamiętaj, aby przed opublikowaniem gry najpierw opublikować jej ustawienia, korzystając z opcji Opublikuj grę w Konsoli Play. Aby dowiedzieć się, jak opublikować zmiany, przeczytaj artykuł Publikowanie zmian w grze.

Dodatkowe wskazówki znajdziesz w przewodniku rozwiązywania problemów z Androidem.

Dalsze kroki

Po wykonaniu opisanych powyżej początkowych zadań konfiguracyjnych możesz włączyć w swojej grze funkcje usług gier Play, takie jak zapisane gry, tabele wyników i osiągnięcia.