Начало работы с игровыми сервисами Play для Android

Внимание! Это руководство предназначено для использования SDK Play Games Services v1. Информацию о последней версии SDK смотрите в документации v2 .

Добро пожаловать в мир разработки игр для 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:

1. Загрузите образцы Android со страницы загрузки образцов .
2. Импортируйте проект android-basic-samples . Этот проект включает TypeANumber и другие образцы игр для Android. Чтобы сделать это в Android Studio:
   1. Нажмите «Файл» > «Импортировать проект» .
   2. Перейдите в каталог, в который вы загрузили android-basic-samples на свой компьютер для разработки. Выберите файл android-basic-samples/build.gradle и нажмите «ОК» .
3. В модуле TypeANumber откройте AndroidManifest.xml и измените имя пакета с com.google.example.games.tanc на другое собственное имя пакета. Имя нового пакета не должно начинаться с com.google , com.example или com.android .

Шаг 2. Настройте игру в консоли Google Play.

Консоль Google Play — это место, где вы управляете игровыми сервисами Google Play для своей игры и настраиваете метаданные для авторизации и аутентификации вашей игры.

Чтобы настроить образец игры в консоли Google Play:

1. Направьте свой веб-браузер на консоль Google Play и войдите в систему. Если вы еще не регистрировались в консоли Google Play, вам будет предложено это сделать.
2. Следуйте этим инструкциям, чтобы добавить свою игру в консоль Google Play .
   1. На вопрос, используете ли вы API Google в своем приложении, выберите «Я пока не использую API Google в своей игре» .
   2. Для целей данного руководства для разработчиков вы можете заполнить форму, указав сведения о своей игре. Для удобства вы можете использовать значки-заполнители и снимки экрана, представленные на странице «Загрузки» .
3. Следуйте этим инструкциям, чтобы создать идентификатор клиента OAuth 2.0 для вашего приложения Android.
   1. При связывании приложения Android обязательно укажите точное имя пакета, которое вы использовали ранее при переименовании образца пакета.
   2. Вы можете использовать мастер создания подписанного APK в Android Studio, чтобы создать новое хранилище ключей и подписанный сертификат, если у вас его еще нет. Чтобы узнать, как запустить мастер создания подписанного APK, см. раздел «Подписание приложения в Android Studio» .
4. Обязательно запишите следующую информацию на будущее:
   1. Идентификатор вашего приложения: это строка, состоящая только из цифр (обычно 12 или более), в начале вашего идентификатора клиента.
   2. Ваш сертификат подписи: обратите внимание, какой сертификат вы использовали при настройке доступа к API (сертификат, отпечаток SHA1 которого вы предоставили). Вы должны использовать тот же сертификат для подписи своего приложения при тестировании или выпуске приложения.
5. Настройте достижения для испытания «Введите число»:
   1. Выберите вкладку «Достижения» в консоли Google Play.
   2. Добавьте следующие примеры достижений:

      Имя	Описание	Специальные инструкции
      Основной	Получите счет, который является простым числом.	Никто
      Скромный	Запросите оценку 0.	Никто
      Не зазнавайся, малыш	Запросите оценку 9999 в любом режиме.	Никто
      ОМГ УР ТЕХ УБЕР ЛИТ!	Получите оценку 1337.	Сделайте это скрытым достижением.
      Скучающий	Сыграйте в игру 10 раз.	Сделайте это дополнительным достижением с 10 шагами для разблокировки.
      Действительно очень скучно	Сыграйте в игру 100 раз.	Сделайте это дополнительным достижением, требующим разблокировки 100 шагов.

   3. Запишите идентификаторы (длинные буквенно-цифровые строки) для каждого созданного вами достижения.
   4. Настройте достижения, подходящие для вашей игры. Чтобы узнать больше, ознакомьтесь с концепциями достижений и способами реализации достижений в Android .
6. Настройте таблицы лидеров для испытания «Введите число»:
   1. Выберите вкладку «Списки лидеров» в консоли Google Play.
   2. Добавьте два образца таблицы лидеров: одну с названием «Легкие рекорды», а другую — «Сложные рекорды». В обеих таблицах лидеров должно использоваться целочисленное форматирование очков с 0 десятичных знаков, лучше использовать тип упорядочения «Большой» .
   3. Запишите идентификаторы (длинные буквенно-цифровые строки) для каждой созданной вами таблицы лидеров.
   4. Настройте таблицы лидеров, подходящие для вашей игры. Чтобы узнать больше, ознакомьтесь с концепциями таблиц лидеров и способами их реализации в Android .
7. Добавьте тестовые аккаунты для своей игры . Этот шаг необходим только для приложений, которые еще не опубликованы в консоли Google Play. До публикации приложения в систему могут войти только тестовые учетные записи, перечисленные в консоли Google Play. Однако после публикации приложения войти в систему смогут все.

Предупреждение. Если вы попытаетесь вызвать Play Games SDK для неопубликованной игры, используя учетную запись, которая не указана в качестве тестовой учетной записи, игровые службы Google Play будут вести себя так, как если бы игра не существовала, и вы получите обратно ConnectionResult.SIGN_IN_REQUIRED код возврата. Если вы попытаетесь запустить ConnectionResult.startResolutionForResult() , вы получите обратно GamesActivityResultCodes.RESULT_SIGN_IN_FAILED .

Шаг 3. Измените свой код

Чтобы запустить игру, вам необходимо настроить идентификатор приложения как ресурс в вашем Android-проекте. Вам также потребуется добавить метаданные игры в AndroidManifest.xml .

1. Откройте res/values/ids.xml и замените идентификаторы заполнителей. Если вы создаете игру для Android с нуля, вам сначала необходимо создать этот файл.
   1. Укажите идентификатор вашего приложения в ресурсе app_id .
   2. Укажите каждый идентификатор достижения, который вы создали ранее, в соответствующем ресурсе achievement_* .
   3. Укажите идентификатор каждого списка лидеров, который вы создали ранее, в соответствующем ресурсе leaderboard_* .
2. Откройте 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.

Примечание. Рекомендуется выполнять тестирование на физическом устройстве Android. Однако, если у вас нет физического устройства, вы можете протестировать его с помощью эмулятора Android . Для этого загрузите образ системы эмулятора, включающий службы Google Play, под Android 4.2.2 из SDK Manager .

Чтобы запустить игру на физическом тестовом устройстве:

1. Убедитесь, что вы настроили тестовую учетную запись, которую используете для входа в приложение (как описано в шаге 2).
2. Экспортируйте APK и подпишите его тем же сертификатом, который вы использовали для настройки проекта в консоли Google Play. Чтобы экспортировать подписанный APK в Android Studio, нажмите «Сборка» > «Создать подписанный APK» .
3. Установите подписанный APK на физическое тестовое устройство с помощью инструмента adb . Чтобы узнать, как установить приложение, см. Запуск на устройстве .

Предупреждение. Когда вы запускаете приложение непосредственно из Android Studio, Android Studio по умолчанию подпишет приложение с помощью вашего сертификата отладки. Если вы не использовали этот отладочный сертификат при настройке приложения в Google Play Console, это приведет к ошибкам. Обязательно запустите APK-файл, который вы экспортировали и подписали с помощью сертификата, соответствующего одному из сертификатов, которые вы использовали при настройке приложения в консоли Google Play.