Настройте игровые сервисы Google Play

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

Чтобы добавить свою игру в Play Console, выполните следующие общие шаги:

  • Создайте игровой проект для своей игры и укажите такие детали, как название и описание игры.

  • Создайте и свяжите необходимые учетные данные для авторизации и аутентификации вашей игры в сервисах Google Play Games.

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

Перед настройкой сервисов Google Play Games выполните следующие шаги.

Создайте аккаунт разработчика Google Play.

Создайте проект в Google Cloud.

Необходимо предварительно настроить проект в Google Cloud. Для получения дополнительной информации см.

Для использования Play Console необходимо включить API, которые вы планируете использовать в своем проекте.

Консоль

Включить API Google Play Game Services

gcloud 

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

Войдите в Play Console

Для входа в систему перейдите в Google Play Console . Если вы ранее не регистрировались в Play Console, вам будет предложено это сделать.

Добавьте свою игру в Play Console

Чтобы добавить свою игру, выполните следующие шаги:

  1. В Play Console создайте приложение и укажите, что это игра. Для получения дополнительной информации см. раздел «Создание и настройка приложения» .

  2. Перейдите в раздел «Развитие» > «Службы Play Games» > «Настройка и управление» > «Конфигурация» .

  3. Укажите, использует ли ваша игра уже API Google (например, Firebase). Важно выбрать правильный вариант; в противном случае при использовании API Google в игре могут возникнуть проблемы. Вот доступные варианты:

    • Нет, моя игра не использует API Google : Если вы создаете новую игру или никогда не настраивали для нее API Google, выберите этот вариант. Введите название вашей игры и нажмите «Создать» .

    • Да, моя игра уже использует API Google : выберите этот вариант, если вы уже настроили API Google для игры. В этом случае вы увидите список своих проектов в консоли Google Cloud. Выберите свой проект из списка и нажмите «Использовать» .

    • Использовать существующий проект Play Games Services : Если вы хотите использовать существующий проект Play Games Services, выберите этот вариант. Вы увидите список существующих проектов Play Games Services для вашей учетной записи. Выберите свой игровой проект из списка и нажмите « Использовать ». Это нетипичный выбор, но вы можете использовать его, если создаете новую игру в Play Console, чтобы изменить имя пакета, или если у вас есть бесплатная и платная версии игры с разными именами пакетов.

    Создается игровой проект Play Games Services, и для вас создается соответствующая запись в консоли Google Cloud .

  4. В разделе «Свойства» нажмите «Редактировать свойства» , чтобы добавить информацию, такую ​​как описание, категория и графические ресурсы для вашей игры. Вот несколько рекомендаций по настройке свойств:

Сгенерируйте идентификатор клиента OAuth 2.0.

Для аутентификации и авторизации вашей игры к сервисам Google Play Games Services необходимо иметь идентификатор клиента OAuth 2.0. Чтобы настроить учетные данные для Play Games Services, которые представляют собой связь между идентификатором клиента и вашей игрой, используйте Google Cloud Platform для создания идентификатора клиента. Затем используйте Google Play Console для добавления учетных данных, связывающих идентификатор клиента с вашей игрой.

Более подробные инструкции см. в следующих шагах:

Если вы еще не настроили экран согласия OAuth, в разделе «Учетные данные» отобразится сообщение с предложением выполнить настройку.

Запрос на настройку экрана согласия OAuth.

Нажмите «Настроить» . Откроется диалоговое окно с дальнейшими инструкциями и прямой ссылкой на платформу Google Cloud.

Вам будет предложено настроить экран согласия OAuth.

Убедитесь, что экран согласия доступен всем, кому доступна игра. В окончательный список областей действия (scopes) должны входить games , games_lite и drive.appdata ; ни одна из этих областей не потребует подтверждения приложения. Мы рекомендуем опубликовать экран согласия немедленно. Если это невозможно, вы можете сделать экран согласия доступным для тестировщиков, чтобы они могли пройти аутентификацию в игре.

Если вы завершили настройку экрана согласия OAuth, нажмите «Готово» . Google Play Console автоматически обновится, и если настройка прошла успешно, вы сможете создать учетные данные:

Создание учетных данных

Создать учетные данные

Для того чтобы разрешить вашей игре взаимодействовать с сервисами Google Play Games, необходимо создать учетные данные с авторизованным идентификатором клиента OAuth2.

В разделе «Учетные данные» нажмите «Добавить учетные данные» .

В мастере выберите, хотите ли вы создать учетные данные Android (если APK-файл вашей игры будет аутентифицировать пользователя и использовать API сервисов Play Games) или учетные данные игрового сервера (если ваш игровой сервер будет использовать API сервисов Play Games). Следуйте инструкциям, соответствующим выбранному вами типу учетных данных.

Android

Настройка учетных данных

Убедитесь, что имя в поле «Имя» совпадает с названием вашей игры. Выберите, следует ли включить защиту от пиратства .

Настройка авторизации

Далее выберите идентификатор клиента OAuth для использования в этом игровом проекте. Если у вас уже есть идентификаторы клиентов OAuth2, вы можете выбрать один. Однако обычно вам потребуется создать новый. Нажмите «Создать клиент OAuth» . Откроется диалоговое окно со ссылками и инструкциями по созданию идентификатора клиента OAuth в Google Cloud Platform.

  1. Выберите Android в качестве типа приложения.
  2. Введите название вашей игры в поле «Название» .
  3. В поле «Имя пакета» введите имя пакета вашего Android-приложения.

  4. Откройте терминал и запустите утилиту Keytool , чтобы получить отпечатки SHA1 сертификатов для выпуска и отладки.

    Чтобы получить отпечаток сертификата выпуска, выполните следующую команду:

    keytool -list -keystore <path-to-production-keystore> -v

    Чтобы получить отпечаток отладочного сертификата, выполните следующую команду:

    keytool -list -keystore <path-to-debug-keystore> -v Примечание: В Windows хранилище отладочных ключей находится по адресу C:\Users\<USERNAME>\.android\debug.keystore . В Mac или Linux хранилище отладочных ключей обычно находится по адресу ~/.android/debug.keystore .

  5. Необязательно: если вы создали новое хранилище ключей с помощью Unity Hub, не создавайте новый сертификат, следуя инструкциям из предыдущего шага. Используйте отпечаток SHA1, который вы создали в Unity.

    • Для вывода отпечатка SHA1 на терминал используйте следующую команду:

      keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v

  6. Утилита keytool запрашивает пароль для хранилища ключей. Затем keytool выводит отпечаток пароля на терминал.

  7. Вставьте отпечаток SHA1 в поле « Отпечаток сертификата подписи (SHA1)» .

  8. Нажмите «Создать» .

Для получения дополнительной информации об OAuth 2.0 на Android см. раздел «Аутентификация в службах OAuth2» .

После нажатия кнопки «Готово» в диалоговом окне список доступных идентификаторов клиентов обновится. Выберите созданные вами учетные данные из выпадающего меню и нажмите «Сохранить изменения» . Это создаст учетные данные в качестве черновика, что позволит вам аутентифицироваться в Play Games Services в вашей игре.

Возможно, вам потребуется создать две учетные данные: одну с отпечатком сертификата для релизной версии, а другую — с отпечатком сертификата для отладки. Убедитесь, что для обеих учетных данных используется одно и то же имя пакета. Это позволит Google Play Games Services распознавать вызовы из связанных APK-файлов, подписанных любым из этих сертификатов. Дополнительную информацию о подписании сертификатов для Android см. в разделе «Подпишите свое приложение» .

Игровой сервер

Настройка учетных данных

Убедитесь, что имя в поле «Имя» совпадает с названием вашей игры.

Настройка авторизации

Далее выберите идентификатор клиента OAuth для использования в этом игровом проекте. Если у вас уже есть идентификаторы клиентов OAuth2, вы можете выбрать один. Однако обычно вам потребуется создать новый. Нажмите «Создать клиент OAuth» . Откроется диалоговое окно со ссылками и инструкциями по созданию идентификатора клиента OAuth в Google Cloud Platform.

  1. В качестве типа приложения выберите «Веб-приложение» .
  2. Введите название вашей игры в поле «Название» .
  3. Нажмите «Создать» .

Для получения дополнительной информации об OAuth 2.0 на Android см. раздел «Аутентификация в службах OAuth2» .

После нажатия кнопки «Готово» в диалоговом окне список доступных идентификаторов клиентов обновится. Выберите созданные вами учетные данные из выпадающего меню и нажмите «Сохранить изменения» . Это создаст учетные данные в качестве черновика, что позволит вам аутентифицироваться в Play Games Services с вашего игрового сервера. Для получения дополнительной информации об использовании Play Games Services с вашим игровым сервером см. раздел «Включение доступа к Google Play Games Services на стороне сервера» .

Включить тестирование

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

Если ваша игра находится в неопубликованном состоянии, предоставьте доступ тестировщикам, добавив их учетные записи в список разрешенных. В противном случае тестировщики столкнутся с ошибками OAuth и 404 при попытке доступа к конечным точкам Play Games Services, таким как конечная точка аутентификации платформы .

Пользователи с авторизованными тестовыми учетными записями получат доступ к вашему неопубликованному игровому проекту Play Games Services и смогут проверить корректность работы настроенных вами сервисов Play Games Services.

Существует два способа предоставить тестировщикам возможность использовать API сервисов Play Games для вашей игры:

  • На индивидуальном уровне — путем добавления отдельных адресов электронной почты.

  • На групповом уровне это можно сделать, включив сервисы Play Games для выпуска игр для консолей Play.

Чтобы добавить отдельных тестировщиков в свой игровой проект:

  1. Откройте вкладку «Тестировщики» для вашей игры в консоли Google Play ( Grow > Play Games Services > Настройка и управление > Тестировщики ).
  2. Нажмите кнопку «Добавить тестировщиков» .
  3. В появившемся диалоговом окне введите адреса электронной почты учетных записей Google, которые вы хотите добавить в качестве тестировщиков (разделяя их запятыми или указывая один адрес электронной почты на строку).
  4. Нажмите «Добавить» , чтобы сохранить пользователей в качестве тестировщиков. Добавленные вами учетные записи тестировщиков смогут получить доступ к сервисам Play Games в течение нескольких часов.

Чтобы предоставить группе пользователей доступ к тестированию, включите отслеживание релизов для доступа к сервисам Play Games:

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

Вы можете предоставить доступ к тестированию вашей игры всем пользователям, имеющим доступ к тестовым APK-файлам в рамках определенного релиз-трека. Это работает так же, как если бы вы добавили их в список тестировщиков по отдельности. Для этого выполните следующие шаги:

  1. Откройте раздел «Тестировщики PGS» ( Grow > Play Games Services > Настройка и управление > Тестировщики ) и выберите вкладку « Треки релизов» . На этой странице вы также можете увидеть список треков, которые уже включены для тестирования в Play Games Services.
  2. Нажмите «Добавить треки» .
  3. Выберите один или несколько треков, которые необходимо включить для тестирования сервисов Play Games.
  4. Нажмите «Добавить треки» .

Выбранные треки релизов теперь будут отображаться в списке треков, включенных для тестирования сервисов Play Games.

Эта функция доступна только в том случае, если к вашей игре в Google Play Console подключено приложение для Android.

Избегайте распространенных проблем

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

1. Настройте игру с помощью Play Console.
Если вы создали идентификатор клиента OAuth 2.0 для своего приложения в консоли Google Cloud, сервисы Google Play Games не будут знать о связи между достижениями и таблицами лидеров игры и этим идентификатором клиента. Чтобы установить эту связь, необходимо создать учетные данные, используя идентификатор клиента OAuth 2.0, как описано в разделе «Создание учетных данных» .
2. Используйте правильный идентификатор приложения в Android.
Идентификатор приложения — это обязательный строковый ресурс, на который необходимо ссылаться в вашем Android-манифесте. Строка идентификатора приложения состоит только из цифр (обычно 12 или более) в начале идентификатора клиента, предоставленного Play Console. Идентификатор приложения можно найти в верхней части страницы конфигурации , он обозначен как Project ID под названием вашей игры.
3. Подпишите свой APK-файл с помощью соответствующего сертификата.
При связывании вашего Android-приложения с игрой в Play Console необходимо использовать точно такое же имя пакета и отпечаток сертификата, которые вы использовали при публикации приложения. В случае несоответствия вызовы к Google Play Games Services завершатся неудачей. Вам следует создать два идентификатора клиента: один с отпечатком сертификата для релизной версии, а другой — с отпечатком сертификата для отладочной версии, и использовать для обоих одно и то же имя пакета. Подробнее о том, как указать сертификат подписи в Play Console, см. в разделе «Подписание приложений» .
4. При разработке для Android включайте Play Games SDK в качестве проекта-библиотеки, а не в виде отдельного JAR-файла.
Убедитесь, что SDK Google Play Services указан в качестве библиотечного проекта в вашем проекте Android, иначе это может привести к ошибкам, когда ваше приложение не сможет найти ресурсы Google Play Services. Чтобы узнать, как настроить ваш проект Android для использования Google Play Services, см. раздел «Настройка Google Play Services» .
5. Во время разработки войдите в систему с помощью учетной записи тестировщика.
Если вы не опубликовали изменения настроек игры в Play Console, во время тестирования могут возникнуть ошибки, если вы не вошли в систему с учетной записью тестировщика из белого списка. Всегда включайте учетную запись издателя Play Console для тестирования. Чтобы узнать, как управлять учетными записями тестировщиков, см. раздел «Включение учетных записей для тестирования» .
6. Опубликуйте экран подтверждения согласия на платформе Google Cloud Platform.
Перед публикацией приложения в Play Console, опубликуйте экран согласия в Google Cloud Platform. Без этого шага пользователи не смогут использовать ни одну из функций Play Games Services.
7. При выпуске сначала опубликуйте настройки Play Games Services, прежде чем публиковать свою игру.
Разработчики могут случайно опубликовать свое приложение, не опубликовав соответствующие настройки Play Games Services. Это может привести к ошибкам у игроков, авторизующихся с помощью учетных записей, не являющихся тестовыми, поскольку приложение не сможет получить доступ к правильным настройкам игры. При выпуске игры не забудьте сначала опубликовать настройки игры, используя опцию «Опубликовать игру» в Play Console. Чтобы узнать, как опубликовать изменения, см. раздел «Публикация изменений игры» .

Дополнительные советы см. в руководстве по устранению неполадок Android .

Следующие шаги

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