Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

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

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

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

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

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

minSdkVersion — 19 или выше.
compileSdkVersion 28 или выше

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

В консоли Google Play вы управляете сервисами Google Play Games для своей игры и настраиваете метаданные для авторизации и аутентификации игры. Дополнительную информацию см. в разделе «Настройка сервисов Google Play Games» .

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

В файле build.gradle на уровне проекта укажите репозиторий Maven от Google и центральный репозиторий Maven как в разделе buildscript , так и в разделе allprojects :

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Добавьте зависимость сервисов Google Play для SDK Play Games в файл сборки Gradle вашего модуля , который обычно находится по адресу app/build.gradle :

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

Пример руководства по использованию приложения

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

Шаг 1: Загрузите демонстрационную версию приложения.

Для ознакомления с этим руководством для разработчиков вам потребуется загрузить демонстрационное приложение для Android "Type-a-Number Challenge".

Чтобы загрузить и установить пример приложения в Android Studio:

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

Шаг 2: Настройте игру в Google Play Console.

В консоли Google Play вы управляете сервисами Google Play Games для своей игры и настраиваете метаданные для авторизации и аутентификации вашей игры.

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

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

Настройка достижений для игры «Введи число»:

В консоли Google Play выберите вкладку «Достижения» .

Добавьте следующие примеры достижений:

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

Запишите идентификаторы (длинные буквенно-цифровые строки) для каждого созданного вами достижения.
Настройте достижения, подходящие для вашей игры. Чтобы узнать больше, ознакомьтесь с концепциями достижений и способами их реализации в Android .

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

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

Для запуска игры необходимо указать идентификатор приложения в качестве ресурса в вашем проекте Android. Также потребуется добавить метаданные игры в файл AndroidManifest.xml .

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

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

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