Добро пожаловать в разработку игр для Android с помощью игровых сервисов Google Play!
Play Games SDK предоставляет кроссплатформенные игровые сервисы Google Play, которые позволяют легко интегрировать популярные игровые функции, такие как достижения, списки лидеров и сохраненные игры, в игры для планшетов и мобильных устройств.
В ходе этого обучения вы узнаете, как установить образец игрового приложения для Android и быстро приступить к созданию собственной игры для Android. Пример приложения «Напечатай число» демонстрирует, как можно интегрировать достижения и таблицы лидеров в свою игру.
Прежде чем начать
Чтобы подготовить приложение, выполните действия, описанные в следующих разделах.
Предварительные требования приложения
Убедитесь, что в файле сборки вашего приложения используются следующие значения:
-
minSdkVersion
19
или выше -
compileSdkVersion
28
или выше.
Настройте свою игру в консоли Google Play.
Консоль Google Play — это место, где вы управляете игровыми сервисами Google Play для своей игры и настраиваете метаданные для авторизации и аутентификации вашей игры. Дополнительную информацию см. в разделе «Настройка игровых сервисов Google Play» .
Настройте свое приложение
В файле build.gradle
на уровне проекта включите репозиторий Google Maven и центральный репозиторий Maven как в разделы buildscript
, так и в разделы allprojects
:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
Добавьте зависимость сервисов Google Play для Play Games SDK в файл сборки Gradle вашего модуля (обычно это app/build.gradle
):
dependencies {
implementation 'com.google.android.gms:play-services-games:23.2.0'
}
Пример руководства по приложению
В ходе этого обучения вы узнаете, как установить образец игрового приложения для Android и быстро приступить к созданию собственной игры для Android. Пример приложения «Напечатай число» демонстрирует, как можно интегрировать достижения и таблицы лидеров в свою игру.
Шаг 1. Загрузите образец приложения.
Для работы с этим руководством разработчика вам потребуется загрузить пример приложения для Android «Напечатай число».
Чтобы загрузить и настроить пример приложения в Android Studio:
- Загрузите образцы Android со страницы загрузки образцов .
- Импортируйте проект
android-basic-samples
. Этот проект включаетTypeANumber
и другие образцы игр для Android. Чтобы сделать это в Android Studio:- Нажмите «Файл» > «Импортировать проект» .
- Перейдите в каталог, в который вы загрузили
android-basic-samples
на свой компьютер для разработки. Выберите файлandroid-basic-samples/build.gradle
и нажмите «ОК» .
- В модуле
TypeANumber
откройтеAndroidManifest.xml
и измените имя пакета сcom.google.example.games.tanc
на другое собственное имя пакета. Имя нового пакета не должно начинаться сcom.google
,com.example
илиcom.android
.
Шаг 2. Настройте игру в консоли Google Play.
Консоль Google Play — это место, где вы управляете игровыми сервисами Google Play для своей игры и настраиваете метаданные для авторизации и аутентификации вашей игры.
Чтобы настроить образец игры в консоли Google Play:
- Направьте свой веб-браузер на консоль Google Play и войдите в систему. Если вы ранее не регистрировались в консоли Google Play, вам будет предложено это сделать.
- Следуйте этим инструкциям, чтобы добавить свою игру в консоль Google Play .
- На вопрос, используете ли вы API Google в своем приложении, выберите «Я пока не использую API Google в своей игре» .
- Для целей данного руководства для разработчиков вы можете заполнить форму, указав сведения о своей игре. Для удобства вы можете использовать значки-заполнители и снимки экрана, представленные на странице «Загрузки» .
- Следуйте этим инструкциям, чтобы создать идентификатор клиента OAuth 2.0 для вашего приложения Android.
- При связывании приложения Android обязательно укажите точное имя пакета, которое вы использовали ранее при переименовании образца пакета.
- Вы можете использовать мастер создания подписанного APK в Android Studio, чтобы создать новое хранилище ключей и подписанный сертификат, если у вас его еще нет. Чтобы узнать, как запустить мастер создания подписанного APK, см. раздел «Подписание приложения в Android Studio» .
- Обязательно запишите следующую информацию на будущее:
- Идентификатор вашего приложения : это строка, состоящая только из цифр (обычно 12 или более), в начале вашего идентификатора клиента.
- Ваш сертификат подписи: обратите внимание, какой сертификат вы использовали при настройке доступа к API (сертификат, отпечаток SHA1 которого вы предоставили). Вы должны использовать тот же сертификат для подписи своего приложения при тестировании или выпуске приложения.
- Настройте достижения для испытания «Введите число»:
- Выберите вкладку «Достижения» в консоли Google Play.
- Добавьте следующие примеры достижений:
Имя Описание Специальные инструкции Основной Получите счет, который является простым числом. Никто Скромный Запросите оценку 0. Никто Не зазнавайся, малыш Запросите оценку 9999 в любом режиме. Никто ОМГ УР ТЕХ УБЕР ЛИТ! Получите оценку 1337. Сделайте это скрытым достижением. Скучающий Сыграйте в игру 10 раз. Сделайте это дополнительным достижением с 10 шагами для разблокировки. Действительно очень скучно Сыграйте в игру 100 раз. Сделайте это дополнительным достижением, требующим разблокировки 100 шагов. - Запишите идентификаторы (длинные буквенно-цифровые строки) для каждого созданного вами достижения.
- Настройте достижения, подходящие для вашей игры. Чтобы узнать больше, ознакомьтесь с концепциями достижений и способами реализации достижений в Android .
- Настройте таблицы лидеров для испытания «Введите число»:
- Выберите вкладку «Списки лидеров» в консоли Google Play.
- Добавьте два образца таблицы лидеров: одну с названием «Легкие рекорды», а другую — «Сложные рекорды». В обеих таблицах лидеров должно использоваться целочисленное форматирование очков с 0 десятичных знаков, лучше использовать тип упорядочения «Большой» .
- Запишите идентификаторы (длинные буквенно-цифровые строки) для каждой созданной вами таблицы лидеров.
- Настройте таблицы лидеров, подходящие для вашей игры. Чтобы узнать больше, ознакомьтесь с концепциями таблиц лидеров и способами их реализации в Android .
- Добавьте тестовые аккаунты для своей игры . Этот шаг необходим только для приложений, которые еще не опубликованы в консоли Google Play. До публикации приложения в систему могут войти только тестовые учетные записи, перечисленные в консоли Google Play. Однако после публикации приложения вход в систему разрешен всем.
Шаг 3. Измените свой код
Чтобы запустить игру, вам необходимо настроить идентификатор приложения как ресурс в вашем проекте Android. Вам также потребуется добавить метаданные игры в AndroidManifest.xml
.
- Откройте
res/values/ids.xml
и замените идентификаторы заполнителей. Если вы создаете игру для Android с нуля, вам сначала необходимо создать этот файл.- Укажите идентификатор вашего приложения в ресурсе
app_id
. - Укажите каждый идентификатор достижения, который вы создали ранее, в соответствующем ресурсе
achievement_*
. - Укажите идентификатор каждого списка лидеров, который вы создали ранее, в соответствующем ресурсе
leaderboard_*
.
- Укажите идентификатор вашего приложения в ресурсе
- Откройте
AndroidManifest.xml
и введите имя своего пакета в атрибутpackage
элементаmanifest
. Если вы создаете игру для Android с нуля, обязательно добавьте следующий код внутрь элемента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"/>
Шаг 4. Проверьте свою игру
Чтобы убедиться в корректной работе игровых сервисов Google Play в вашей игре, протестируйте приложение перед публикацией его в Google Play.
Чтобы запустить игру на физическом тестовом устройстве:
- Убедитесь, что вы настроили тестовую учетную запись, которую используете для входа в приложение (как описано в шаге 2).
- Экспортируйте APK и подпишите его тем же сертификатом, который вы использовали для настройки проекта в консоли Google Play. Чтобы экспортировать подписанный APK в Android Studio, нажмите «Сборка» > «Создать подписанный APK» .
- Установите подписанный APK на физическое тестовое устройство с помощью инструмента
adb
. Чтобы узнать, как установить приложение, см. Запуск на устройстве .