Pierwsze kroki z usługami gier Play na Androida

Uwaga: ten przewodnik dotyczy korzystania z pakietu SDK usług gier Play w wersji 1. Informacje o najnowszym pakiecie SDK znajdziesz w dokumentacji Usługi gier Play w wersji 2.

Witamy w tworzeniu gier na Androida dzięki usługom gier Google Play.

Pakiet SDK Gier Play udostępnia działające na wielu platformach usługi Google Play, które pozwalają łatwo zintegrować popularne funkcje gier, takie jak osiągnięcia, tabele wyników czy zapisane gry, w grach na tablecie i urządzeniach mobilnych.

Dzięki temu szkoleniu dowiesz się, jak zainstalować przykładową grę na Androida i szybko zacząć tworzyć własną grę. Przykładowa aplikacja typu Wyzwanie typu-a-liczba pokazuje, jak włączyć osiągnięcia i tablice wyników w grze.

Zanim zaczniesz

Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.

Wymagania wstępne aplikacji

Upewnij się, że plik kompilacji aplikacji zawiera te wartości:

• minSdkVersion z 19 większego
• wartość compileSdkVersion wynosząca co najmniej 28,

Skonfiguruj grę w Konsoli Google Play

Konsola Google Play to miejsce, w którym możesz zarządzać usługami gier Google Play związanymi z Twoją grą oraz konfigurować metadane na potrzeby autoryzacji i uwierzytelniania gry. Więcej informacji znajdziesz w artykule Konfigurowanie usług gier Google Play.

Konfiguracja aplikacji

W plikach build.gradle na poziomie projektu uwzględnij repozytorium Google Maven i centralne repozytorium Maven w sekcjach buildscript i allprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Dodaj zależność Usług Google Play do pakietu SDK Gier Play do pliku build.gradle modułu. Jest to zwykle app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

Przykładowy przewodnik po aplikacjach

Z tego szkolenia dowiesz się, jak zainstalować przykładową grę na Androida i szybko zacząć tworzyć własną grę. Przykładowa aplikacja typu Wyzwanie typu-a-liczba pokazuje, jak włączyć osiągnięcia i tablice wyników w grze.

Krok 1. Pobierz przykładową aplikację

Aby zapoznać się z tym przewodnikiem dla programistów, musisz pobrać przykładową aplikację na Androida typu Challenge Challenge (typ-a-Number).

Aby pobrać i skonfigurować przykładową aplikację w Android Studio:

1. Przykłady na Androida możesz pobrać ze strony pobierania przykładów.
2. Zaimportuj projekt android-basic-samples. Ten projekt obejmuje grę TypeANumber i inne przykłady gier na Androida. Aby to zrobić w Android Studio:
   1. Kliknij File (Plik) > Import Project (Importuj projekt).
   2. Przejdź do katalogu, do którego został pobrany android-basic-samples na komputerze, z którego korzystasz. Wybierz plik android-basic-samples/build.gradle i kliknij OK.
3. W module TypeANumber otwórz AndroidManifest.xml i zmień nazwę pakietu z com.google.example.games.tanc na własną. Nowa nazwa pakietu nie może zaczynać się od com.google, com.example ani com.android.

Krok 2. Skonfiguruj grę w Konsoli Google Play

Konsola Google Play to miejsce, w którym zarządzasz usługami gier Google Play dotyczącymi Twojej gry oraz konfigurujesz metadane na potrzeby autoryzacji i uwierzytelniania gry.

Aby skonfigurować przykładową grę w Konsoli Google Play:

1. Otwórz Konsolę Google Play w przeglądarce i zaloguj się. Jeśli nie masz jeszcze rejestracji w Konsoli Google Play, pojawi się prośba, by to zrobić.
2. Wykonaj te czynności, aby dodać grę do Konsoli Google Play.
   1. Gdy pojawi się pytanie, czy w swojej aplikacji korzystasz z interfejsów API Google, wybierz Nie używam jeszcze żadnych interfejsów API Google w mojej grze.
   2. Na potrzeby tego przewodnika dla programistów możesz wypełnić formularz informacjami o własnej grze. Dla wygody możesz użyć ikon zastępczych i zrzutów ekranu dostępnych na stronie Pobrane.
3. Wykonaj te instrukcje, aby wygenerować identyfikator klienta OAuth 2.0 dla swojej aplikacji na Androida.
   1. Podczas łączenia aplikacji na Androida pamiętaj, by podać dokładną nazwę pakietu użyta wcześniej przy zmianie nazwy pakietu przykładowego.
   2. Możesz użyć kreatora generowania podpisanego pliku APK w Android Studio, aby wygenerować nowy magazyn kluczy i podpisany certyfikat, jeśli jeszcze go nie masz. Informacje o tym, jak uruchomić kreator generowania podpisanego pliku APK, znajdziesz w artykule o podpisywaniu aplikacji w Android Studio.
4. Zapisz te informacje na później:
   1. Identyfikator aplikacji: to ciąg składający się tylko z cyfr (zwykle 12 lub więcej) na początku identyfikatora klienta.
   2. Twój certyfikat podpisywania: zapisz certyfikat użyty podczas konfigurowania dostępu do interfejsu API (certyfikat, którego odcisk cyfrowy SHA1 został przez Ciebie podany). Podczas testowania lub publikowania aplikacji używaj tego samego certyfikatu.
5. Konfigurowanie osiągnięć w wyzwaniu typu a-Number:
   1. W Konsoli Google Play wybierz kartę Osiągnięcia.
   2. Dodaj te przykładowe osiągnięcia:

      Nazwa	Opis	Specjalne instrukcje
      Prim	Uzyskaj wynik, który jest liczbą pierwszą.	Brak
      Humble	Poproś o wynik 0.	Brak
      Nie rób się, dzieciaku	Poproś o wynik 9999 w obu trybach.	Brak
      O JO LET!	Wynik 1337.	Niech to będzie ukryte osiągnięcie.
      Nudny	Zagrać w grę 10 razy.	Niech to będzie osiągnięcie stopniowe – trzeba będzie jeszcze wykonać 10 kroków.
      Bardzo się nudzi	zagrać w grę 100 razy;	Niech to będzie osiągnięcie stopniowe. Musisz zdobyć jeszcze 100 kroków.

   3. Zapisuj identyfikatory (długie ciągi alfanumeryczne) każdego utworzonego osiągnięcia.
   4. Skonfiguruj osiągnięcia odpowiednie dla Twojej gry. Więcej informacji znajdziesz w artykułach o koncepcjach związanych z osiągnięciami i o ich implementowaniu na Androidzie.
6. Skonfiguruj tabele wyników w wyzwaniu typu „Type-a-Number”:
   1. Wybierz kartę Tabele wyników w Konsoli Google Play.
   2. Dodaj 2 przykładowe tabele wyników: jedną o nazwie „Łatwy rekord”, a drugą „Wysoki wynik”. W obu tabelach wyników należy podać liczbę całkowitą z 0 miejsc po przecinku oraz typ kolejności Większe, tym lepsze.
   3. Zanotuj identyfikatory (długie ciągi alfanumeryczne) każdej utworzonej tabeli wyników.
   4. Skonfiguruj tabele wyników odpowiednie dla Twojej gry. Więcej informacji znajdziesz w artykule o pojęciach związanych z tabelami wyników i o implementowaniu takich tabel na Androidzie.
7. Dodaj konta testowe gry. Ten krok jest wymagany tylko w przypadku aplikacji, które nie zostały jeszcze opublikowane w Konsoli Google Play. Przed opublikowaniem aplikacji można się logować tylko z kont testowych wymienionych w Konsoli Google Play. Jednak po opublikowaniu aplikacji każdy może się zalogować.

Ostrzeżenie: jeśli spróbujesz wywołać przez pakiet SDK Gier Play nieopublikowaną grę, korzystając z konta, które nie jest wymienione jako konto testowe, usługi gier Google Play będą działać tak, jakby gra nie istniała, i otrzymasz zwrot ConnectionResult.SIGN_IN_REQUIRED. Jeśli spróbujesz uruchomić ConnectionResult.startResolutionForResult(), wrócisz GamesActivityResultCodes.RESULT_SIGN_IN_FAILED.

Krok 3. Zmodyfikuj kod

Aby uruchomić grę, musisz skonfigurować identyfikator aplikacji jako zasób w projekcie Androida. Musisz też dodać metadane gier w pliku AndroidManifest.xml.

1. Otwórz plik res/values/ids.xml i zastąp identyfikatory zastępcze. Jeśli tworzysz grę na Androida od podstaw, musisz najpierw utworzyć ten plik.
   1. Podaj identyfikator aplikacji w zasobie app_id.
   2. Podaj każdy utworzony wcześniej identyfikator osiągnięcia w odpowiednim zasobie achievement_*.
   3. Podaj każdy utworzony wcześniej identyfikator tabeli wyników w odpowiednim zasobie leaderboard_*.
2. Otwórz AndroidManifest.xml i wpisz nazwę pakietu w atrybucie package elementu <manifest>. Jeśli tworzysz grę na Androida od zera, pamiętaj, aby dodać też ten kod do elementu <application>:

   <meta-data android:name="com.google.android.gms.games.APP_ID"
       android:value="@string/app_id" />
   <meta-data android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version"/>
   

Krok 4. Przetestuj grę

Aby mieć pewność, że usługi gier Google Play będą działać w Twojej grze, przetestuj ją przed opublikowaniem w Google Play.

Uwaga: zalecamy przeprowadzenie testów na fizycznym urządzeniu z Androidem. Jeśli jednak nie masz fizycznego urządzenia, możesz wykonać test za pomocą emulatora Androida. Aby to zrobić, pobierz z Menedżera SDK obraz systemu emulatora zawierający Usługi Google Play w wersji Android 4.2.2.

Aby uruchomić grę na fizycznym urządzeniu testowym:

1. Sprawdź, czy masz skonfigurowane konto testowe, którego używasz do logowania się w aplikacji (zgodnie z opisem w kroku 2).
2. Wyeksportuj plik APK i podpisz go tym samym certyfikatem, którego użyto do skonfigurowania projektu w Konsoli Google Play. Aby wyeksportować podpisany pakiet APK w Android Studio, kliknij Kompilacja > Wygeneruj podpisany pakiet APK.
3. Zainstaluj podpisany plik APK na fizycznym urządzeniu testowym za pomocą narzędzia adb. Aby dowiedzieć się, jak zainstalować aplikację, zobacz sekcję Uruchamianie na urządzeniu.

Ostrzeżenie: gdy uruchamiasz aplikację bezpośrednio w Android Studio, Android Studio domyślnie podpisuje ją Twoim certyfikatem debugowania. Jeśli podczas konfigurowania aplikacji w Konsoli Google Play nie użyto tego certyfikatu debugowania, spowoduje to wystąpienie błędów. Pamiętaj, aby uruchomić wyeksportowany i podpisany certyfikatem zgodnym z którymś z certyfikatów użytych podczas konfigurowania aplikacji w Konsoli Google Play.