Konfigurowanie usług gier Google Play

Z tego artykułu dowiesz się, jak skonfigurować usługi gier Google Play dla gry na Androida, używając Konsoli Google Play. Konsola Play to scentralizowane miejsce do zarządzania usługami gier i konfigurowania metadanych używanych do autoryzowania i uwierzytelniania gry.

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

  • Utwórz projekt gry i podaj szczegółowe informacje, takie jak nazwa i opis gry.

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

Zanim zaczniesz

Logowanie się w Konsoli Play

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

Dodaj grę 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 o tworzeniu i konfigurowaniu aplikacji.

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

  3. Określ, czy Twoja gra korzysta już z interfejsów API Google (np. Firebase). Ważne jest, aby wybrać właściwą opcję. W przeciwnym razie podczas korzystania z interfejsów API Google mogą wystąpić problemy z grą. Dostępne opcje to:

    • Nie, moja gra nie korzysta z interfejsów API Google: wybierz tę opcję, jeśli tworzysz nową grę lub nigdy nie skonfigurowano dla niej interfejsu API Google. Wpisz nazwę gry i kliknij Utwórz.

    • Tak, moja gra korzysta już z 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 i kliknij Użyj.

    • Użyj istniejącego projektu w usługach gier Play: wybierz tę opcję, jeśli chcesz użyć istniejącego projektu usług gier Play. Zobaczysz listę projektów w usługach gier Play istniejących na Twoim koncie. Wybierz z listy projekt gry i kliknij Użyj. Nie jest to typowy wybór, ale możesz tak zrobić, 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.

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

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

Wygeneruj identyfikator klienta OAuth 2.0

Aby gra mogła być uwierzytelniona i autoryzowana do wywoływania usług gier Google Play, musi mieć identyfikator klienta OAuth 2.0. Aby skonfigurować dane logowania do usług gier Play (czyli powiązanie między identyfikatorem klienta i grą), utwórz identyfikator klienta w Google Cloud Platform. Następnie za pomocą Konsoli Google Play dodaj dane logowania łączące identyfikator klienta z 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.

Monituj o skonfigurowanie ekranu zgody OAuth

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

Monituj o skonfigurowanie ekranu zgody OAuth.

Upewnij się, że ekran zgody jest dostępny dla wszystkich użytkowników gry. Ostateczna lista zakresów musi obejmować games, games_lite i drive.appdata. Żaden z tych zakresów nie będzie wymagać weryfikacji aplikacji. Zalecamy jak najszybciej opublikować ekran zgody. Jeśli to niemożliwe, możesz udostępnić testerom ekran zgody, aby mogli zalogować się w grze.

Po skonfigurowaniu ekranu zgody OAuth kliknij Gotowe. Konsola Google Play odświeża się automatycznie, a jeśli konfiguracja zakończy się powodzeniem, będziesz mieć możliwość utworzenia danych logowania:

Tworzenie danych logowania

Tworzenie danych logowania

Aby upoważnić grę do komunikowania się z usługami gier Google 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 na Androida (jeśli pakiet APK gry będzie uwierzytelniać użytkownika i używać interfejsów API usług gier Play) czy dane logowania do 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 szczegółów danych logowania

Upewnij się, że nazwa w polu Nazwa jest taka sama jak nazwa gry. Wybierz, czy chcesz włączyć Antypiractwo.

Autoryzacja konfiguracji

Następnie wybierz identyfikator klienta OAuth, którego chcesz używać w tym projekcie gry. Jeśli masz już identyfikator klienta OAuth2, możesz go wybrać. Zwykle tworzy się jednak nowe. Kliknij Utwórz klienta OAuth. Otworzy się okno z precyzyjnymi linkami 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 swojej 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

  5. Narzędzie Keytool poprosi o podanie hasła do magazynu kluczy. Domyślne hasło magazynu kluczy debugowania to android. Keytool drukuje odcisk cyfrowy na terminalu.

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

  7. 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, dostępne identyfikatory klientów zostaną odświeżone. Wybierz w menu utworzone dane logowania i kliknij Zapisz zmiany. Spowoduje to utworzenie danych logowania w wersji roboczej, co umożliwi uwierzytelnianie w usługach gier Play w swojej grze.

Możesz utworzyć 2 dane logowania: jeden z odciskiem cyfrowym certyfikatu wersji i drugi z odciskiem cyfrowym certyfikatu debugowania. Użyj tej samej nazwy pakietu w obu językach. Dzięki temu usługi gier Google Play mogą rozpoznawać wywołania z połączonych plików APK podpisanych dowolnym z nich. Więcej informacji o podpisywaniu certyfikatów w Androidzie znajdziesz w artykule Podpisywanie aplikacji.

Serwer gry

Konfigurowanie szczegółów danych logowania

Upewnij się, że nazwa w polu Nazwa jest taka sama jak nazwa gry.

Autoryzacja konfiguracji

Następnie wybierz identyfikator klienta OAuth, którego chcesz używać w tym projekcie gry. Jeśli masz już identyfikator klienta OAuth2, możesz go wybrać. Zwykle tworzy się jednak nowe. Kliknij Utwórz klienta OAuth. Otworzy się okno z precyzyjnymi linkami 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, dostępne identyfikatory klientów zostaną odświeżone. Wybierz w menu utworzone dane logowania i kliknij Zapisz zmiany. Spowoduje to utworzenie danych logowania w wersji roboczej, co umożliwi uwierzytelnianie z serwera gier w usługach gier Play. Więcej informacji o używaniu usług gier Play na serwerze gry znajdziesz w artykule o włączaniu 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, przetestuj je przed opublikowaniem zmian w grze w Google Play.

Jeśli Twoja gra jest nieopublikowana, przyznaj dostęp testerom, dodając ich konta użytkowników do listy dozwolonych. W przeciwnym razie podczas próby uzyskania dostępu do punktów końcowych usług gier Play, np. do punktu końcowego logowania, testerzy napotkają błędy OAuth i 404.

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

Są 2 sposoby, aby umożliwić testerom korzystanie z interfejsów API usług gier Play w Twojej grze:

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

  • Na poziomie grupy przez włączenie usług gier Play dla ścieżki wersji Konsoli Play.

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

  1. W Konsoli Google Play otwórz kartę Testerzy swojej gry (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órych chcesz dodać jako testerów (oddzielając je przecinkami lub po jednym adresie e-mail w wierszu).
  4. Kliknij Dodaj, aby zapisać użytkowników jako testerów. 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 testowania, włącz ścieżkę wersji, aby uzyskać dostęp do usług gier Play:

Google Play ułatwia rozpowszechnianie przedpremierowych wersji aplikacji w kontrolowanych grupach zaufanych użytkowników dzięki funkcjom ścieżki wersji. Przeczytaj artykuł 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 pakietów APK na danej ścieżce wersji. Działa to tak samo jak w przypadku dodania go do listy testerów osobno. Jak to zrobić:

  1. Otwórz sekcję Testerzy w usługach gier Play (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ż objęte testowaniem w usługach gier Play.
  2. Kliknij Dodaj ścieżki.
  3. Wybierz co najmniej 1 ścieżkę, którą chcesz przetestować w usługach gier Play.
  4. Kliknij Dodaj ścieżki.

Wybrane ścieżki wersji pojawią się na liście ścieżek objętych testami w usługach gier Play.

Ta funkcja jest dostępna tylko wtedy, gdy masz aplikację na Androida powiązaną ze swoją 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 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 swojej aplikacji, Usługi gier Google Play nie będą wiedzieć, jakie jest powiązanie między osiągnięciem w grze a tabelami wyników a identyfikatorem klienta. Aby utworzyć to powiązanie, musisz utworzyć dane logowania przy użyciu identyfikatora klienta OAuth 2.0 zgodnie z opisem w sekcji Tworzenie danych logowania.
2. Używanie prawidłowego identyfikatora aplikacji na Androidzie
Identyfikator aplikacji jest wymaganym zasobem tekstowym, do którego musisz się odwołać w pliku manifestu Androida. Ciąg 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. Ma on etykietę Identyfikator projektu pod nazwą gry.
3. Podpisz plik APK odpowiednim certyfikatem
Gdy łączysz aplikację na Androida z grą w Konsoli Play, musisz używać dokładnie tej samej nazwy pakietu i odcisku cyfrowego certyfikatu, które zostały użyte do opublikowania aplikacji. W przypadku niezgodności połączenia z usługami gier Google Play zakończą się niepowodzeniem. Utwórz dwa identyfikatory klienta – jeden z odciskiem cyfrowym certyfikatu wersji i drugi z odciskiem cyfrowym certyfikatu debugowania, i w obu przypadkach użyj tej samej nazwy pakietu. Więcej informacji o określaniu certyfikatu podpisywania w Konsoli Play znajdziesz w artykule Podpisywanie aplikacji.
4. Jeśli tworzysz aplikację na Androida, dodaj pakiet SDK Gier Play jako projekt biblioteki, a nie samodzielny plik JAR.
Sprawdź, czy w projekcie na Androida odwołuje się pakiet SDK Usług Google Play do projektu biblioteki. W przeciwnym razie może to spowodować błędy, gdy aplikacja nie będzie mogła znaleźć zasobów Usług Google Play. Aby dowiedzieć się, jak skonfigurować projekt na Androida pod kątem Usług Google Play, przeczytaj artykuł Konfigurowanie Usług Google Play.
5. Logowanie się na konto testera na etapie tworzenia aplikacji
Jeśli nie opublikujesz zmian ustawień gry w Konsoli Play i nie zalogujesz się na konto testerów z białej listy, podczas testowania możesz napotkać błędy. Zawsze włączaj do testów swoje konto wydawcy w Konsoli Play. Aby dowiedzieć się, jak zarządzać kontami testerów, przeczytaj artykuł Włączanie kont do 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 publiczni odbiorcy nie będą mogli korzystać z żadnych funkcji usług gier Play.
7. Zanim opublikujesz grę, najpierw opublikuj 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 logują się za pomocą kont innych niż testerzy, ponieważ aplikacja nie może wskazać prawidłowych ustawień gry. Podczas publikowania gry pamiętaj, aby najpierw opublikować jej ustawienia za pomocą 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 zadań wstępnych związanych z konfiguracją możesz włączyć funkcje usług gier Play, takie jak zapisane gry, tabele wyników i osiągnięcia.