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

В связи с прекращением поддержки API входа Google мы удалим SDK для игр v1 в 2026 году. После февраля 2025 года вы не сможете публиковать в Google Play игры, недавно интегрированные с SDK для игр v1. Вместо этого мы рекомендуем использовать SDK для игр v2.
Хотя существующие игры с интеграцией предыдущих игр v1 продолжат функционировать еще пару лет, вам рекомендуется перейти на v2, начиная с июня 2025 года.
Это руководство посвящено использованию SDK Play Games Services v1. Информацию о последней версии SDK см. в документации v2 .

Добро пожаловать в разработку игр для Android с помощью игровых сервисов Google Play!

Play Games SDK предоставляет кроссплатформенные игровые сервисы Google Play, которые позволяют легко интегрировать популярные игровые функции, такие как достижения, таблицы лидеров и сохраненные игры, в игры для планшетов и мобильных устройств.

Это обучающее видео поможет вам установить пример игрового приложения для Android и быстро приступить к созданию собственной игры. Пример приложения «Type-a-Number Challenge» демонстрирует, как интегрировать достижения и таблицы лидеров в свою игру.

Прежде чем начать

Чтобы подготовить свое приложение, выполните действия, описанные в следующих разделах.

Предварительные требования к приложению

Убедитесь, что файл сборки вашего приложения использует следующие значения:

• minSdkVersion версии 19 и выше
• compileSdkVersion 28 или выше

Настройте свою игру в Google Play Console

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

Настройте свое приложение

В файле build.gradle уровня проекта включите репозиторий Maven от Google и центральный репозиторий 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 и быстро приступить к созданию собственной игры. Пример приложения «Type-a-Number Challenge» демонстрирует, как интегрировать достижения и таблицы лидеров в свою игру.

Шаг 1: Загрузите пример приложения

Для использования этого руководства разработчика вам потребуется загрузить пример приложения Type-a-Number Challenge для 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 Console

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

Чтобы настроить пример игры в Google Play Console:

1. Откройте в веб-браузере Google Play Console и войдите в систему. Если вы ранее не регистрировались в Google Play Console, вам будет предложено сделать это.
2. Следуйте этим инструкциям, чтобы добавить свою игру в Google Play Console .
   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. Настройте достижения для испытания Type-a-Number:
   1. Выберите вкладку «Достижения» в консоли Google Play.
   2. Добавьте следующие примеры достижений:

      Имя	Описание	Специальные инструкции
      Основной	Получите результат, являющийся простым числом.	Никто
      Скромный	Запросить оценку 0.	Никто
      Не будь самоуверенным, малыш.	Запросите оценку 9999 в любом режиме.	Никто
      О боже, это просто супер!	Получите оценку 1337.	Сделайте это скрытым достижением.
      Скучающий	Сыграйте в игру 10 раз.	Сделайте это постепенным достижением, разблокировав его за 10 шагов.
      Очень-очень скучно	Сыграйте в игру 100 раз.	Сделайте это постепенным достижением, для разблокировки которого вам потребуется выполнить 100 шагов.

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

Внимание: если вы попытаетесь выполнить вызовы Play Games SDK для неопубликованной игры, используя учётную запись, не указанную как тестовую, сервисы Google Play Games будут вести себя так, как будто игра не существует, и вы получите код возврата 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 .

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

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

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