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

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

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

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

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

Прежде чем вы начнете

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

Требования к приложению

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

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

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

Консоль 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.1.0'
  }

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

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

Шаг 1. Загрузите образец приложения

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

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

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

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

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

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

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

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

   3. Запишите идентификаторы (длинные буквенно-цифровые строки) для каждого созданного вами достижения.
   4. Настройте достижения, подходящие для вашей игры. Чтобы узнать больше, ознакомьтесь с понятиями, лежащими в основе достижений , и о том, как реализовать достижения в Android .
6. Настройте списки лидеров для соревнования Type-a-Number:
   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 .

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

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.