Pierwsze kroki z usługami gier Play na Androida

Witamy w rozwoju gier na Androida z użyciem Usług gier Google Play

Pakiet SDK do gier Play udostępnia działające na wielu platformach usługi gier 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.

W tym szkoleniu dowiesz się, jak zainstalować przykładową aplikację do gier na Androida i szybko rozpocząć tworzenie własnej gry na Androida. 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:

  • wartość minSdkVersion wynosząca co najmniej 19.
  • wartość compileSdkVersion wynosząca co najmniej 28,

Skonfiguruj grę w Konsoli Google Play

W Konsoli Google Play możesz zarządzać usługami gier Google Play dotyczącymi swojej gry oraz konfigurować metadane służące do autoryzacji i uwierzytelniania gry. Więcej informacji znajdziesz w artykule Konfigurowanie Usług gier Google Play.

Konfigurowanie aplikacji

W pliku build.gradle na poziomie projektu dodaj repozytorium Maven firmy Googlecentralne repozytorium Maven w sekcjach buildscriptallprojects:

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

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

Dodaj zależność Usług Google Play do pakietu SDK Usług gier Google 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'
  }

Przewodnik po przykładowej aplikacji

W tym szkoleniu dowiesz się, jak zainstalować przykładową aplikację z grą na Androida i szybko rozpocząć tworzenie własnej gry na Androida. Przykładowa aplikacja Type-a-Number Challenge pokazuje, jak zintegrować osiągnięcia i tablice liderów ze swoją grą.

Krok 1. Pobierz przykładową aplikację

Aby skorzystać z tego przewodnika dla deweloperów, musisz pobrać przykładową aplikację na Androida Type-a-Number Challenge.

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

  1. Pobierz przykłady na Androida ze strony z przykładami do pobrania.
  2. Zaimportuj projekt android-basic-samples. Ten projekt zawiera TypeANumber i inne przykładowe gry na Androida. Aby to zrobić w Android Studio:
    1. Kliknij Plik > Importuj projekt.
    2. Na komputerze z programem do tworzenia aplikacji odszukaj katalog, do którego został pobrany plik android-basic-samples. 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 inną nazwę. Nowa nazwa pakietu nie może zaczynać się od com.google, com.example ani com.android.

Krok 2. Skonfiguruj grę w Konsoli Google Play

W Konsoli Google Play możesz zarządzać usługami gier Google Play dotyczącymi swojej gry oraz konfigurować metadane służące do 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 konta w Konsoli Google Play, pojawi się prośba o jego utworzenie.
  2. Wykonaj te czynności, aby dodać grę do Konsoli Google Play.
    1. Gdy pojawi się pytanie, czy w aplikacji używasz interfejsów API Google, wybierz Nie korzystam jeszcze w swojej grze z interfejsów API Google.
    2. W tym przewodniku dla deweloperów możesz wypełnić formularz, podając własne dane dotyczące gry. Dla wygody możesz użyć ikon i zrzutów ekranu udostępnionych na stronie Pobrane.
  3. Aby utworzyć identyfikator klienta OAuth 2.0 dla aplikacji na Androida, wykonaj te czynności:
    1. Podczas łączenia aplikacji na Androida podaj dokładnie tę samą nazwę pakietu, której użyłaś/używałeś podczas zmiany nazwy przykładowego pakietu.
    2. Jeśli nie masz jeszcze nowego repozytorium kluczy i podpisanego certyfikatu, możesz użyć kreatora wygenerowania podpisanego pliku APK w Android Studio. 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: ciąg znaków składający się wyłącznie z cyfr (zazwyczaj co najmniej 12 cyfr) 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 i publikowania aplikacji należy używać tego samego certyfikatu do podpisywania aplikacji.
  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 Instrukcje specjalne
      Prim Uzyskaj wynik, który jest liczbą pierwszą. Brak
      Skromność Poproś o wynik 0. Brak
      Nie bądź arogancki, dzieciaku. Poproś o wynik 9999 w obu trybach. Brak
      OMG U R TEH UBER LEET! Otrzymaj wynik 1337. Ustaw to osiągnięcie jako ukryte.
      Znudzenie Zagrać w grę 10 razy. Niech to będzie osiągnięcie stopniowe – trzeba będzie jeszcze wykonać 10 kroków.
      Really Really Bored Zagraj w grę 100 razy. Niech to będzie osiągnięcie stopniowe. Musisz zdobyć jeszcze 100 kroków.
    3. Zanotuj 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 artykule Osiągnięcia – podstawy oraz Wdrażanie osiągnięć na Androida.
  6. Skonfiguruj tabele wyników dla wyzwania „Wpisz liczbę”:
    1. W Konsoli Google Play kliknij kartę Listy liderów.
    2. Dodaj 2 przykładowe tabele wyników: jedną o nazwie „Łatwe wysokie wyniki” i drugą o nazwie „Trudne wysokie wyniki”. Obie tabele powinny używać formatu wyników całkowitych z 0 miejscami po przecinku i typu sortowania Więcej punktów jest lepsze.
    3. Zanotuj identyfikatory (długie ciągi alfanumeryczne) każdej utworzonej przez siebie tablicy liderów.
    4. Skonfiguruj tabele wyników odpowiednie dla Twojej gry. Więcej informacji znajdziesz w artykułach Koncepcje stojące za tabelami wynikówJak wdrożyć tabele wyników na Androidzie.
  7. Dodaj do gry konta testowe. Ten krok jest potrzebny tylko w przypadku aplikacji, które nie zostały jeszcze opublikowane w Konsoli Google Play. Zanim aplikacja zostanie opublikowana, logować się mogą tylko konta testowe wymienione w Konsoli Google Play. Jednak po opublikowaniu aplikacji każdy może się zalogować.

Krok 3. Zmień 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. Wpisz identyfikator aplikacji w zasobie app_id.
    2. Podaj każdy utworzony wcześniej identyfikator osiągnięcia w odpowiednim zasobie achievement_*.
    3. Współczynniki wskaźnika wyników, które zostały utworzone wcześniej, należy określić w odpowiednich zasobach leaderboard_*.
  2. Otwórz plik AndroidManifest.xml i w atrybut package elementu <manifest> wpisz nazwę pakietu. Jeśli tworzysz grę na Androida od podstaw, pamiętaj też o dodaniu tego kodu w elemencie <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 Google Play Games działają prawidłowo w Twojej grze, przetestuj aplikację przed opublikowaniem jej w Google Play.

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

  1. Sprawdź, czy masz skonfigurowane konto testowe, którego używasz do logowania się w aplikacji (jak opisano w kroku 2).
  2. Wyeksportuj plik APK i podpisz go tym samym certyfikatem, którego użyłeś/użyłaś 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.