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 programie tworzenia gier na Androida z usługami gier Google Play.

Pakiet SDK Gier Play to międzyplatformowe usługi gier Google Play, które pozwalają łatwo zintegrować popularne funkcje gier, takie jak osiągnięcia, tabele wyników i Zapisane gry, na tabletach i grach mobilnych.

To szkolenie pomoże Ci zainstalować przykładową grę na Androida i szybko rozpocząć tworzenie własnej gry. Przykładowa aplikacja typu Wyzwanie typu numer pokazuje, jak zintegrować osiągnięcia i tabele wyników ze swoją grą.

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 wyższej wartości
• wartość compileSdkVersion wynosząca co najmniej 28,

Skonfiguruj grę w Konsoli Google Play

Konsola Google Play to miejsce, w którym zarządzasz usługami gier Google Play dotyczącymi gry oraz konfigurujesz metadane służące do autoryzowania i uwierzytelniania gry. Więcej informacji znajdziesz w artykule Konfigurowanie usług gier Google Play.

Konfiguracja aplikacji

W sekcji buildscript i allprojects pliku build.gradle na poziomie projektu dodaj repozytorium Google Maven i centralne repozytorium Maven:

  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.1.0'
  }

Przewodnik po przykładowej aplikacji

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 numer pokazuje, jak zintegrować osiągnięcia i tabele wyników ze swoją grą.

Krok 1. Pobierz przykładową aplikację

Do tego przewodnika dla programistów musisz pobrać przykładową aplikację typu Wyzwanie typu-liczba na Androida.

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

1. Możesz pobrać przykłady na Androida ze strony pobierania przykładów.
2. Zaimportuj projekt android-basic-samples. Ten projekt obejmuje TypeANumber i inne przykłady gier na Androida. Aby to zrobić w Android Studio:
   1. Kliknij Plik > Importuj projekt.
   2. Przejdź do katalogu, do którego został pobrany plik android-basic-samples na komputer. 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 gry oraz konfigurujesz metadane służące do autoryzowania 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 Konsoli Google Play, pojawi się odpowiednia prośba.
2. Wykonaj te instrukcje, aby dodać grę do Konsoli Google Play.
   1. Gdy pojawi się pytanie, czy w swojej aplikacji używasz interfejsów API Google, wybierz Nie używam jeszcze żadnych interfejsów API Google w swojej grze.
   2. Zgodnie z tym przewodnikiem dla programistów możesz wypełnić formularz, podając w nim szczegóły swojej gry. Dla wygody możesz używać 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 podaj dokładnie taką nazwę pakietu, która została użyta podczas zmiany nazwy przykładowego pakietu.
   2. Za pomocą kreatora generowania podpisanego pliku APK w Android Studio możesz wygenerować nowy magazyn kluczy i podpisany certyfikat, jeśli jeszcze go nie masz. Informacje o tym, jak uruchomić kreatora generowania podpisanych plików APK, znajdziesz w sekcji Podpisywanie aplikacji w Android Studio.
4. Pamiętaj, aby zapisać te informacje na później:
   1. Identyfikator aplikacji: ciąg znaków składający się tylko z cyfr (zwykle co najmniej 12) na początku identyfikatora klienta.
   2. Certyfikat podpisywania: zapisz certyfikat użyty do skonfigurowania dostępu do interfejsu API (certyfikat, którego odcisk cyfrowy podany przez Ciebie SHA1). Używaj tego samego certyfikatu do podpisywania aplikacji podczas jej testowania lub publikowania.
5. Skonfiguruj osiągnięcia w Wyzwaniu-liczbowym.
   1. W Konsoli Google Play wybierz kartę Osiągnięcia.
   2. Dodaj te przykładowe osiągnięcia:

      Nazwa	Opis	Specjalne instrukcje
      Prime	Uzyskaj wynik, który jest liczbą pierwszą.	Brak
      Humble	Poproś o wynik równy 0.	Brak
      Nie wygłupiaj się, dzieciaku	Poproś o wynik 9999 w każdym z tych trybów.	Brak
      OMG U R TĘ TŁE LEET!	Otrzymasz wynik 1337.	Ustaw to osiągnięcie jako ukryte.
      Znudzenie	Zagraj w grę 10 razy.	Postaraj się, aby było to osiągnięcie stopniowe, które wymaga od nas 10 kroków.
      Naprawdę naprawdę nudny	Zagraj w grę 100 razy.	Postaraj się, aby było to osiągnięcie stopniowe, które odblokuje 100 kroków.

   3. Zapisz identyfikatory (długie ciągi alfanumeryczne) każdego utworzonego osiągnięcia.
   4. Skonfiguruj osiągnięcia odpowiednie dla Twojej gry. Aby dowiedzieć się więcej, przeczytaj koncepcje stojące za osiągnięciami i sposoby ich wdrażania na Androidzie.
6. Przygotuj tabele wyników w wyzwaniu typu-liczba:
   1. W Konsoli Google Play kliknij kartę Tabele wyników.
   2. Dodaj dwie przykładowe tabele wyników: jedną o nazwie „Łatwe najlepsze wyniki” i drugą o nazwie „Twarde wyniki”. Obie tabele wyników powinny mieć format liczby całkowitej z 0 miejscami po przecinku, a rodzajem kolejności Im większe.
   3. Zanotuj identyfikatory (długie ciągi alfanumeryczne) każdej utworzonej tabeli wyników.
   4. Skonfiguruj tabele wyników odpowiednie do Twojej gry. Aby dowiedzieć się więcej, zapoznaj się z koncepcjami dotyczącymi tabel wyników oraz sposobem ich implementacji na Androidzie.
7. Dodaj konta testowe swojej gry. Ten krok jest wymagany tylko w przypadku aplikacji, które nie zostały jeszcze opublikowane w Konsoli Google Play. Przed opublikowaniem aplikacji mogą się logować tylko konta testowe podane w Konsoli Google Play. Po opublikowaniu aplikacji każdy może się jednak zalogować.

Ostrzeżenie: jeśli spróbujesz wywołać nieopublikowaną grę w pakiecie SDK Gier Play, używając konta, które nie jest wymienione jako konto testowe, usługi gier Google Play będą działać tak, jakby gra nie istniała, a Ty otrzymasz kod zwrotu ConnectionResult.SIGN_IN_REQUIRED. Jeśli spróbujesz uruchomić grę ConnectionResult.startResolutionForResult(), odzyskasz dostęp do GamesActivityResultCodes.RESULT_SIGN_IN_FAILED.

Krok 3. Zmodyfikuj kod

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

1. Otwórz plik res/values/ids.xml i zastąp identyfikatory zastępcze. Jeśli tworzysz grę na Androida od podstaw, najpierw musisz utworzyć ten plik.
   1. Podaj identyfikator aplikacji w zasobie app_id.
   2. Podaj każdy identyfikator osiągnięcia, który został utworzony wcześniej w odpowiednim zasobie achievement_*.
   3. Podaj każdy identyfikator tabeli wyników utworzony wcześniej 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 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 gier Google Play działają w Twojej grze prawidłowo, przetestuj ją, zanim opublikujesz ją w Google Play.

Uwaga: zalecamy przeprowadzanie testów na fizycznym urządzeniu z Androidem. Jeśli jednak nie masz urządzenia fizycznego, możesz przeprowadzić test, korzystając z emulatora Androida. Aby to zrobić, z Menedżera pakietów SDK pobierz 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óry został użyty do skonfigurowania projektu w Konsoli Google Play. Aby wyeksportować podpisany pakiet APK w Android Studio, kliknij Build > Generate Signed APK (Wygeneruj podpisany pakiet APK).
3. Zainstaluj podpisany pakiet APK na fizycznym urządzeniu testowym, korzystając z narzędzia adb. Aby dowiedzieć się, jak zainstalować aplikację, zapoznaj się z sekcją Uruchamianie na urządzeniu.

Ostrzeżenie: gdy uruchomisz aplikację bezpośrednio z Android Studio, Android Studio domyślnie podpisze ją z Twoim certyfikatem debugowania. Jeśli nie użyjesz tego certyfikatu debugowania podczas konfigurowania aplikacji w Konsoli Google Play, spowoduje to błędy. Pamiętaj, aby uruchomić plik APK wyeksportowany i podpisany z użyciem certyfikatu zgodnego z jednym z certyfikatów użytych podczas konfigurowania aplikacji w Konsoli Google Play.