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

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

Чтобы добавить игру в консоль Google Play, выполните следующие общие действия:

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

Эти шаги более подробно описаны в следующих разделах.

Шаг 1. Войдите в консоль Google Play.

Чтобы войти, перейдите в консоль Google Play . Если вы еще не зарегистрировались в Google Play Console, вам будет предложено это сделать.

Шаг 2. Добавьте свою игру в консоль Google Play.

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

1. Создайте игру в Play Console, если вы еще этого не сделали. Подробнее см. здесь .
2. Перейдите в Grow > Play Games Services > Настройка и управление > Конфигурация .

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

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

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

5. В разделе «Свойства» вы можете выбрать «Изменить свойства» и добавить описание, категорию и графические объекты для своей игры.

   • Для тестирования требуется только отображаемое имя. Остальные поля должны быть заполнены, прежде чем вы сможете опубликовать свою игру.
   • Отображаемое имя и описание вашей игры должны соответствовать тем, которые вы настроили для своей игры в Play Store.
   • Инструкции по созданию графических объектов см. в руководстве Google Play для разработчиков и в Руководстве по использованию рекомендуемых изображений в Google Play .

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

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

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

а. Настройка экрана согласия OAuth

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

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

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

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

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

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

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

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

Андроид

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

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

Настроить авторизацию

Затем выберите идентификатор клиента 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. Утилита keytool предлагает ввести пароль для хранилища ключей. Пароль по умолчанию для хранилища ключей отладки — android . Keytool затем печатает отпечаток пальца на терминал.

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

7. Щелкните Создать .

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

Предупреждение. Обязательно запишите имя пакета и сертификат подписи, которые вы настроили на этом шаге. Использование другого имени сертификата или пакета в приложении приведет к сбоям аутентификации.

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

Вы можете создать две учетные данные: одну с отпечатком сертификата выпуска и одну с отпечатком сертификата отладки. Обязательно используйте одно и то же имя пакета для обоих. Это позволяет 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 с игровым сервером см. в разделе Включение доступа на стороне сервера к игровым сервисам Google Play .

Как избежать распространенных проблем с настройкой

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

1. Настройте игру с помощью консоли Google Play.

Если вы создали идентификатор клиента Oauth 2.0 для своего приложения в Google Cloud Console, игровые сервисы Google Play не будут знать о связи между игровыми достижениями и списками лидеров и идентификатором клиента. Чтобы создать эту ассоциацию, вы должны создать учетные данные, используя идентификатор клиента Oauth 2.0, как описано в разделе Создание учетных данных .

2. Используйте правильный идентификатор приложения в Android

Идентификатор приложения — это обязательный строковый ресурс, на который вы должны ссылаться в своем манифесте Android. Строка идентификатора приложения состоит только из цифр (обычно 12 или более) в начале идентификатора клиента, предоставленного консолью Google Play. Идентификатор приложения можно найти в верхней части страницы конфигурации , он помечен как идентификатор проекта под названием вашей игры.

3. Подпишите APK с правильным сертификатом

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

4. При разработке для Android включайте Play Games SDK как библиотечный проект, а не как отдельный JAR-файл.

Убедитесь, что SDK сервисов Google Play указан как проект библиотеки в вашем проекте Android, иначе это может привести к ошибкам, когда ваше приложение не сможет найти ресурсы сервисов Google Play. Чтобы узнать, как настроить Android-проект для использования сервисов Google Play, см. раздел Настройка сервисов Google Play .

5. Войдите в систему с учетной записью тестировщика во время разработки

Если вы не опубликовали изменения настроек игры в Google Play Console, вы можете столкнуться с ошибками во время тестирования, если вы не вошли в систему с учетной записью тестировщика из белого списка. Вы всегда должны включать свою учетную запись издателя Google Play Console для тестирования. Чтобы узнать, как управлять учетными записями тестировщиков, см. раздел Включение учетных записей для тестирования .

6. Опубликуйте экран согласия в Google Cloud Platform.

Перед публикацией приложения в Google Play Console опубликуйте экран согласия в Google Cloud Platform. Без этого шага публичная аудитория не сможет использовать какие-либо функции Play Games Services.

7. При выпуске сначала опубликуйте настройки игровых сервисов Play, прежде чем публиковать свою игру.

Разработчики могут случайно опубликовать свое приложение, не опубликовав соответствующие настройки игровых сервисов Google Play для своего приложения. Это может привести к тому, что игроки, которые входят в систему с учетными записями, не являющимися тестировщиками, столкнутся с ошибками, поскольку приложение не может ссылаться на правильные настройки игры. При выпуске игры не забудьте сначала опубликовать настройки игры, используя параметр «Опубликовать игру» в консоли Google Play. Чтобы узнать, как опубликовать изменения, см. раздел Публикация изменений в игре .

Для получения дополнительных советов см.:

• Руководство по устранению неполадок Android — документация для разработчиков, описывающая способы устранения неполадок при разработке игр для Android.

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

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

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