Konfigurowanie usług gier Google Play

Z tej strony 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 Twojej 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 uwierzytelnić grę w usługach gier Google Play.

Zanim rozpoczniesz

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

Utwórz konto dewelopera w Google Play

• Musisz mieć konto dewelopera w Google Play skonfigurowane w Konsoli Play. Więcej informacji znajdziesz w artykule Zakładanie konta dewelopera w Google Play.

• Przyznaj uprawnienia do edycji: aby edytować ustawienia usług gier Play w Konsoli Play, Twój zespół musi mieć uprawnienia do zarządzania tymi usługami. Więcej informacji znajdziesz w artykule Dodawanie użytkowników konta dewelopera i zarządzanie uprawnieniami.

Utwórz projekt Google Cloud

Musisz skonfigurować projekt Google Cloud. Więcej informacji znajdziesz w tych artykułach:

• Pierwsze kroki z Google Cloud
• Tworzenie projektu

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

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

Zaloguj się 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.

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 Tworzenie i konfigurowanie 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ć prawidłową opcję. W przeciwnym razie podczas korzystania z interfejsów API Google mogą wystąpić problemy. 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ś(-aś) 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 w grze. W takim przypadku zobaczysz listę projektów z Konsoli Google Cloud. Wybierz projekt z listy i 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 swoim koncie. Wybierz projekt gry z listy i 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 usług Gier Play i odpowiedni wpis zostanie utworzony w konsoli Google Cloud.

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:

   • Do testowania wymagana jest tylko wyświetlana nazwa. Pozostałe pola musisz wypełnić, zanim opublikujesz grę.

   • Wyświetlana nazwa i opis gry powinny być zgodne z tymi, które zostały skonfigurowane na stronie z informacjami o grze w Sklepie Play.

   • Wskazówki dotyczące tworzenia zasobów graficznych znajdziesz w artykule Dodawanie zasobów podglądu, aby zaprezentować aplikację oraz w wytycznych dotyczących obrazu wyróżniającego w Google Play Guidelines.

Wygeneruj identyfikator klienta OAuth 2.0

Aby gra mogła być uwierzytelniana 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 a grą, utwórz identyfikator klienta w Google Cloud. Następnie użyj Konsoli Google Play, aby dodać dane logowania, łącząc identyfikator klienta z grą.

Szczegółowe instrukcje znajdziesz w tych krokach:

Skonfiguruj ekran zgody OAuth

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

Kliknij Skonfiguruj. Spowoduje to otwarcie okna z dalszymi instrukcjami i linkiem do Google Cloud.

Upewnij się, że ekran zgody jest dostępny dla wszystkich, którzy mają dostęp do 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 nie jest to możliwe, możesz udostępnić ekran zgody testerom, aby umożliwić im uwierzytelnianie się w grze.

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

Utwórz dane logowania

Aby autoryzować 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 plik APK gry będzie uwierzytelniać użytkownika i korzystać z interfejsów API usług Gier Play), czy dane logowania serwera gry (jeśli serwer gry będzie korzystać z interfejsów API usług Gier Play). Postępuj zgodnie z instrukcjami dotyczącymi Twojego typu certyfikatu.

Włącz testowanie

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

Jeśli Twoja 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 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 Usług Gier Play i będą mogli sprawdzić, czy skonfigurowane Usługi Gier Play działają prawidłowo.

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

• Na poziomie indywidualnym – przez dodanie poszczególnych adresów e-mail.

• Na poziomie grupy – przez włączenie usług gier Play w ścieżce wersji 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 mieć 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 dystrybuuje przedpremierowe wersje aplikacji do kontrolowanych grup zaufanych użytkowników za pomocą funkcji ś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 testowania plików APK w danej ścieżce wersji. Działa to tak samo, jakbyś dodał(-a) ich do listy testerów indywidualnie. W tym celu wykonaj 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 jedną ścieżkę, którą chcesz włączyć do testowania usług gier Play.
4. Kliknij Dodaj ścieżki.

Wybrane ścieżki wersji pojawią się 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 Google Play postępuj zgodnie z tymi zaleceniami.

1. Skonfiguruj grę w Konsoli Play

Jeśli utworzysz identyfikator klienta OAuth 2.0 dla aplikacji w Konsoli Google Cloud, usługi gier Google Play nie będą wiedzieć o powiązaniu między osiągnięciami i tabelami wyników gry 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żyj prawidłowego identyfikatora aplikacji na Androidzie

Identyfikator aplikacji jest wymaganym zasobem tekstowym, do którego musisz się odwołać w manifeście Androida. Ciąg identyfikatora aplikacji składa się tylko z cyfr (zwykle 12 lub więcej) na początku identyfikatora klienta podanego w Konsoli Play. Identyfikator aplikacji znajdziesz u góry strony Konfiguracja pod nazwą gry, w sekcji Identyfikator projektu.

3. Podpisz plik APK prawidłowym certyfikatem

Podczas łączenia aplikacji na Androida z grą w Konsoli Play, musisz użyć dokładnie tej samej nazwy pakietu i odcisku cyfrowego certyfikatu, których używasz do publikowania aplikacji. Jeśli wystąpi niezgodność, wywołania usług gier Google Play zakończą się niepowodzeniem. Utwórz 2 identyfikatory klienta: 1 z odciskiem cyfrowym certyfikatu wersji, a 2 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 dołącz pakiet SDK usług gier Play jako projekt biblioteki, a nie jako samodzielny plik JAR.

Upewnij się, że pakiet SDK Usług Google Play jest traktowany jako projekt biblioteki w Twoim projekcie aplikacji na Androida. W przeciwnym razie mogą wystąpić błędy, gdy aplikacja nie będzie mogła znaleźć zasobów Usług Google Play. Więcej informacji o tym, jak skonfigurować projekt na Androida do korzystania z Usług Google Play, znajdziesz w artykule Konfigurowanie Usług Google Play.

5. Podczas tworzenia aplikacji zaloguj się na konto testera

Jeśli nie opublikujesz zmian ustawień gry w Konsoli Play, podczas testowania mogą wystąpić błędy, jeśli nie zalogujesz się na konto testera. 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. Opublikuj ekran zgody w Google Cloud

Zanim opublikujesz aplikację w Konsoli Play, opublikuj ekran zgody w Google Cloud. Bez tego kroku publiczni odbiorcy nie będą mogli korzystać z żadnych 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 uwierzytelniający się na kontach innych niż konta testerów będą napotykać błędy, ponieważ aplikacja nie będzie mogła odwołać się do prawidłowych ustawień gry. Podczas publikowania gry pamiętaj, aby najpierw opublikować jej ustawienia, korzystając z opcji Opublikuj grę w Konsoli Play. Więcej informacji o publikowaniu zmian znajdziesz w artykule Publikowanie zmian w grze.

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

Dalsze kroki

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