Konfigurowanie usług gier Google Play

Na tej stronie opisaliśmy, jak skonfigurować Usługi gier Google Play dla swojej gry 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 służące do autoryzacji i uwierzytelniania gry.

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

  • Utwórz projekt gry i podaj 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 Google Play.

Zanim rozpoczniesz

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

Tworzenie konta dewelopera w Google Play

Tworzenie projektu Google Cloud

Musisz skonfigurować projekt Google Cloud. Więcej informacji znajdziesz

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

Konsola

Włączanie interfejsu 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 jego utworzenie.

Dodawanie gry do Konsoli Play

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

  1. W Konsoli Play utwórz aplikację i wskaż, ż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). Ważne jest, aby wybrać prawidłową opcję. W przeciwnym razie gra może mieć problemy z korzystaniem z interfejsów API Google. Oto 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ę swoich projektów z konsoli Google Cloud. Wybierz projekt z listy, a potem kliknij Użyj.

    • Użyj istniejącego projektu usług gier Play: wybierz tę opcję, jeśli chcesz użyć istniejącego projektu usług gier Play. Wyświetli się lista istniejących projektów usług gier Play na Twoim koncie. Na liście wybierz projekt gry, a potem kliknij Użyj. Nie jest to typowy wybór, ale możesz go dokonać, jeśli tworzysz nową grę w Konsoli Play, aby zmienić nazwę pakietu, lub jeśli masz bezpłatne i płatne wersje gry z różnymi nazwami pakietów.

    Utworzony zostanie projekt gry w usługach gier Play, a w konsoli Google Cloud pojawi się odpowiedni wpis.

  4. W sekcji Właściwości kliknij Edytuj właściwości, aby dodać informacje, takie jak opis, kategoria i pliki 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ć grę i zezwolić jej na wywoływanie usług gier Google Play, musi ona mieć identyfikator klienta OAuth 2.0. Aby skonfigurować dane logowania do usług Play Games, czyli powiązać identyfikator klienta z grą, użyj Google Cloud Platform do utworzenia identyfikatora klienta. Następnie w Konsoli Google Play dodaj dane logowania, łącząc identyfikator klienta z Twoją grą.

Aby uzyskać bardziej szczegółowe instrukcje, wykonaj te czynności:

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 z dodatkowymi instrukcjami i linkiem do Google Cloud Platform.

Prośba o skonfigurowanie ekranu zgody OAuth.

Upewnij się, że ekran zgody jest dostępny dla wszystkich użytkowników, dla których dostępna jest gra. Ostateczna lista zakresów musi zawierać games, games_lite i drive.appdata. Żaden z tych zakresów nie wymaga weryfikacji aplikacji. Zalecamy natychmiastowe opublikowanie ekranu z prośbą o zgodę. Jeśli nie jest to możliwe, możesz udostępnić testerom ekran zgody, aby mogli zalogować się w grze.

Jeśli konfiguracja ekranu zgody OAuth została już zakończona, kliknij Gotowe. Konsole Google Play są odświeżane automatycznie, a jeśli konfiguracja przebiegnie pomyślnie, będzie można utworzyć dane logowania:

Tworzenie danych logowania

Tworzenie danych logowania

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

W sekcji Dane logowania kliknij Dodaj dane logowania.

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

Android

Konfigurowanie danych logowania

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

Konfigurowanie autoryzacji

Następnie wybierz identyfikator klienta OAuth, którego chcesz użyć w tym projekcie gry. Jeśli masz już identyfikatory klienta OAuth2, możesz wybrać jeden z nich. Zwykle jednak tworzy się nowe konto. Kliknij Utwórz klienta OAuth. Otworzy się okno z linkami i instrukcjami dotyczącymi 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 uzyskać 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> -vUwaga: w systemie Windows magazyn kluczy debugowania znajduje się w C:\Users\<USERNAME>\.android\debug.keystore. W systemach Mac i Linux magazyn kluczy debugowania znajduje się zwykle w ~/.android/debug.keystore.

  5. Opcjonalnie: jeśli utworzyłeś(-aś) nowe repozytorium kluczy za pomocą Unity Hub, nie twórz nowego certyfikatu, korzystając z instrukcji z poprzedniego kroku. Użyj odcisku palca SHA1 utworzonego w Unity.

    • Aby wydrukować w terminalu odcisk palca SHA1, 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. Następnie 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 protokole OAuth 2 na Androidzie znajdziesz w artykule Uwierzytelnianie w usługach OAuth 2.

Gdy klikniesz Gotowe w oknie dialogowym, dostępne identyfikatory klienta zostaną odświeżone. W menu kliknij utworzone dane logowania, a następnie Zapisz zmiany. Spowoduje to utworzenie danych logowania w postaci szkicu, dzięki czemu będziesz mieć możliwość uwierzytelniania się w usługach gier Play w swojej grze.

Możesz utworzyć 2 dane logowania: jedno z odciskiem cyfrowym certyfikatu wersji, a drugie z odciskiem cyfrowym certyfikatu debugowania. Upewnij się, że używasz tej samej nazwy pakietu w obu przypadkach. Dzięki temu usługi gier Google Play mogą rozpoznawać wywołania z połączonych plików APK, które są podpisane dowolnym z tych certyfikatów. Więcej informacji o podpisywaniu certyfikatów na Androida znajdziesz w artykule Podpisywanie aplikacji.

Serwer gry

Konfigurowanie danych logowania

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

Konfigurowanie autoryzacji

Następnie wybierz identyfikator klienta OAuth, którego chcesz użyć w tym projekcie gry. Jeśli masz już identyfikatory klienta OAuth2, możesz wybrać jeden z nich. Zwykle jednak tworzy się nowe konto. Kliknij Utwórz klienta OAuth. Otworzy się okno z linkami i instrukcjami dotyczącymi 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 Androida znajdziesz w artykule Uwierzytelnianie w usługach OAuth2.

Gdy klikniesz Gotowe w oknie dialogowym, dostępne identyfikatory klienta zostaną odświeżone. W menu kliknij utworzone dane logowania, a następnie Zapisz zmiany. Spowoduje to utworzenie danych logowania w postaci szkicu, dzięki czemu będzie można uwierzytelniać się 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łącz testowanie

Aby mieć pewność, że usługi gier Google Play działają prawidłowo w Twojej grze, przed opublikowaniem zmian w grze w Google Play przetestuj usługi gry.

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

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

Testerzy mogą korzystać z interfejsów API usług gier Play w Twojej grze na 2 sposoby:

  • Na poziomie indywidualnym, przez dodanie pojedynczych adresów e-mail.

  • Na poziomie grupy, przez włączenie Usług Gier Play 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 na wiersz).
  4. Aby zapisać użytkowników jako testerów, kliknij Dodaj. Dodane przez Ciebie konta testerów powinny uzyskać dostęp do Usług gier Play w ciągu kilku godzin.

Aby przyznać grupie dostęp do testów, włącz ścieżkę wersji, która umożliwia dostęp do usług gier Play:

Google Play ułatwia rozpowszechnianie przedpremierowych wersji aplikacji w kontrolowanych grupach zaufanych użytkowników za pomocą funkcji ścieżki wersji. Zapoznaj się z artykułem Przygotowywanie testu otwartego, zamkniętego lub wewnętrznego na stronie 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 wtedy, gdy dodasz je do listy testerów indywidualnie. W tym celu należy wykonać następujące czynności:

  1. Otwórz sekcję Testerzy PGS (Rozwój > Usługi gier Play > Konfiguracja i zarządzanie > Testerzy) i wybierz 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 1 utwór, który ma być testowany w usługach gier Play.
  4. Kliknij Dodaj ścieżki.

Wybrane ścieżki będą teraz widoczne na liście ścieżek włączonych do testowania w usługach gier Play.

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

Unikanie typowych problemów

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

1. Konfigurowanie gry w Konsoli Play
Jeśli w konsoli Google Cloud utworzysz identyfikator klienta OAuth 2.0 dla aplikacji, usługi gier Play nie będą wiedzieć o związku między osiągnięciami i tablicami liderów w grze a identyfikatorem klienta. Aby utworzyć to powiązanie, musisz utworzyć dane logowania za pomocą identyfikatora klienta OAuth 2.0 w sposób opisany w sekcji Tworzenie danych logowania.
2. Używanie prawidłowego identyfikatora aplikacji na Androidzie
Identyfikator aplikacji to wymagany zasób ciągu znaków, na który musisz się powoływać w pliku manifestu Androida. Ciąg znaków identyfikatora aplikacji składa się tylko z cyfr (zazwyczaj co najmniej 12 cyfr) na początku identyfikatora klienta podanego w Konsoli Play. Identyfikator aplikacji znajdziesz u góry strony Konfiguracja. Pod nazwą gry znajduje się oznaczenie Identyfikator projektu.
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 odcisk palca certyfikatu, które zostały użyte do opublikowania aplikacji. Jeśli wystąpi niezgodność, wywołania usług gier w Google Play nie będą działać. Utwórz 2 identyfikatory klienta: jeden z odpisem cyfrowym certyfikatu wersji, a drugi z odpisem cyfrowym certyfikatu debugowania. W obu przypadkach użyj tej samej nazwy pakietu. Aby dowiedzieć się więcej o tym, jak określić certyfikat podpisywania w Konsoli Play, przeczytaj artykuł 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 w Twoim projekcie na Androida jest uwzględniony pakiet SDK Usług Google Play jako projekt biblioteki. W przeciwnym razie aplikacja może generować błędy, gdy nie będzie mogła znaleźć zasobów Usług Google Play. Aby dowiedzieć się, jak skonfigurować projekt 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 opublikowałeś zmian ustawień gry w Konsoli Play, podczas testów możesz napotkać błędy, jeśli nie zalogujesz się na konto testera na białej liście. Zawsze włączaj konto wydawcy w Konsoli Play na potrzeby testowania. Więcej informacji o zarządzaniu kontami testerów znajdziesz w artykule Włączanie kont na potrzeby testowania.
6. Publikowanie ekranu zgody w Google Cloud Platform
Zanim opublikujesz aplikację w Konsoli Play, opublikuj ekran zgody w Google Cloud Platform. Bez tego kroku publiczność nie będzie mogła korzystać z żadnej z funkcji usług gier Play.
7. Przed opublikowaniem gry opublikuj ustawienia usług gier Play
Deweloperzy mogą przypadkowo opublikować aplikację bez opublikowania odpowiednich ustawień usług gier Play. Może to spowodować, że gracze, którzy logują się przy użyciu kont innych niż testowe, będą napotykać błędy, ponieważ aplikacja nie będzie mogła odwoływać się do prawidłowych ustawień gry. Przed wydaniem gry pamiętaj, aby najpierw opublikować ustawienia gry, korzystając z opcji Opublikuj grę w Konsoli Play. Aby dowiedzieć się, jak opublikować zmiany, przeczytaj artykuł Publikowanie zmian w grze.

Więcej wskazówek znajdziesz w przewodniku po rozwiązywaniu problemów z Androidem.

Dalsze kroki

Po wykonaniu opisanych powyżej czynności wstępnych możesz włączyć funkcje Usług gier Play w swojej grze, takie jak zapisane gry, tabele wyników i osiągnięcia.