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 najmniej19
. - wartość
compileSdkVersion
wynosząca co najmniej28
,
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 Google 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 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:
- Pobierz przykłady na Androida ze strony z przykładami do pobrania.
- Zaimportuj projekt
android-basic-samples
. Ten projekt zawieraTypeANumber
i inne przykładowe gry na Androida. Aby to zrobić w Android Studio:- Kliknij Plik > Importuj projekt.
- Na komputerze z programem do tworzenia aplikacji odszukaj katalog, do którego został pobrany plik
android-basic-samples
. Wybierz plikandroid-basic-samples/build.gradle
i kliknij OK.
- W module
TypeANumber
otwórzAndroidManifest.xml
i zmień nazwę pakietu zcom.google.example.games.tanc
na inną nazwę. Nowa nazwa pakietu nie może zaczynać się odcom.google
,com.example
anicom.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:
- 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.
- Wykonaj te czynności, aby dodać grę do Konsoli Google Play.
- 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.
- 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.
- Aby utworzyć identyfikator klienta OAuth 2.0 dla aplikacji na Androida, wykonaj te czynności:
- 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.
- 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.
- Zapisz te informacje na później:
- Identyfikator aplikacji: ciąg znaków składający się wyłącznie z cyfr (zazwyczaj co najmniej 12 cyfr) na początku identyfikatora klienta.
- 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.
- Konfigurowanie osiągnięć w wyzwaniu typu a-Number:
- W Konsoli Google Play wybierz kartę Osiągnięcia.
- 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. - Zanotuj identyfikatory (długie ciągi alfanumeryczne) każdego utworzonego osiągnięcia.
- 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.
- Skonfiguruj tabele wyników dla wyzwania „Wpisz liczbę”:
- W Konsoli Google Play kliknij kartę Listy liderów.
- 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.
- Zanotuj identyfikatory (długie ciągi alfanumeryczne) każdej utworzonej przez siebie tablicy liderów.
- Skonfiguruj tabele wyników odpowiednie dla Twojej gry. Więcej informacji znajdziesz w artykułach Koncepcje stojące za tabelami wyników i Jak wdrożyć tabele wyników na Androidzie.
- 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
.
- 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.- Wpisz identyfikator aplikacji w zasobie
app_id
. - Podaj każdy utworzony wcześniej identyfikator osiągnięcia w odpowiednim zasobie
achievement_*
. - Współczynniki wskaźnika wyników, które zostały utworzone wcześniej, należy określić w odpowiednich zasobach
leaderboard_*
.
- Wpisz identyfikator aplikacji w zasobie
- Otwórz plik
AndroidManifest.xml
i w atrybutpackage
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:
- Sprawdź, czy masz skonfigurowane konto testowe, którego używasz do logowania się w aplikacji (jak opisano w kroku 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.
- 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.