На этой странице описано, как настроить игровые сервисы Google Play для вашей игры Android с помощью консоли Google Play. Play Console предоставляет вам централизованное место для управления игровыми сервисами и настройки метаданных, используемых для авторизации и аутентификации вашей игры.
Чтобы добавить игру в Play Console, выполните следующие общие действия:
Создайте игровой проект для своей игры и укажите такие детали, как название и описание игры.
Создайте и свяжите необходимые учетные данные для авторизации и аутентификации вашей игры в игровых сервисах Google Play.
Прежде чем начать
Прежде чем настраивать игровые сервисы Google Play, выполните следующие действия.
Создайте учетную запись разработчика Google Play.
У вас должна быть учетная запись разработчика Google Play, настроенная в Play Console. Дополнительную информацию см. в разделе Регистрация учетной записи разработчика Google Play .
Предоставьте разрешение на редактирование. Чтобы редактировать настройки игровых сервисов Play в Play Console, у вашей команды должны быть разрешения на управление игровыми сервисами Play. Дополнительные сведения см. в разделе Добавление пользователей учетной записи разработчика и управление разрешениями .
Создайте проект Google Cloud
У вас должен быть настроен проект Google Cloud. Для получения дополнительной информации см.
Войдите в Play Console
Для входа перейдите в консоль Google Play . Если вы ранее не регистрировались в Play Console, вам будет предложено это сделать.
Добавьте свою игру в Play Console
Чтобы добавить свою игру, выполните следующие действия:
В Play Console создайте приложение и укажите, что это игра. Дополнительные сведения см. в разделе Создание и настройка приложения .
Перейдите в раздел «Grow» > «Play Games Services» > «Настройка и управление» > «Конфигурация» .
Укажите, использует ли ваша игра API Google (например, Firebase). Важно, чтобы вы выбрали правильный вариант; в противном случае в вашей игре могут возникнуть проблемы при использовании API Google. Вот варианты:
Нет, моя игра не использует API Google . Если вы создаете новую игру или никогда не настраивали для нее API Google, выберите этот вариант. Введите название вашей игры и нажмите «Создать» .
Да, моя игра уже использует API Google . Выберите этот вариант, если вы уже настроили API Google для игры. В этом случае вы увидите список своих проектов в Google Cloud Console. Выберите свой проект из списка и нажмите « Использовать» .
Использовать существующий проект игровых сервисов Play . Если вы хотите использовать существующий проект игровых сервисов Play, выберите этот вариант. Вы увидите список существующих проектов игровых сервисов Play для вашей учетной записи. Выберите свой игровой проект из списка и нажмите «Использовать» . Это нетипичный выбор, но вы можете сделать это, если создаете новую игру в Play Console, чтобы изменить имя пакета, или если у вас есть бесплатная и платная версии игры с разными именами пакетов.
Создается игровой проект Play Games Services, и для вас создается соответствующая запись в Google Cloud Console .
В разделе «Свойства» нажмите «Изменить свойства», чтобы добавить такую информацию, как описание, категория и графические ресурсы для вашей игры. Вот несколько рекомендаций по настройке свойств:
Для тестирования требуется только отображаемое имя. Остальные поля необходимо заполнить, прежде чем вы сможете опубликовать свою игру.
Отображаемое имя и описание вашей игры должны совпадать с тем, что вы указали в ее списке Play Store.
Рекомендации по созданию графических ресурсов см. в разделах «Добавление ресурсов предварительного просмотра для демонстрации вашего приложения» и «Рекомендации Google Play по избранным изображениям» .
Создайте идентификатор клиента 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 игровых сервисов Play) или учетные данные игрового сервера (если ваш игровой сервер будет использовать API игровых сервисов Play). Следуйте инструкциям, соответствующим желаемому типу учетных данных.
Андроид
Настройка учетных данных
Убедитесь, что имя в поле «Имя» соответствует названию вашей игры. Выберите, включать ли защиту от пиратства .
Настроить авторизацию
Затем выберите идентификатор клиента OAuth, который будет использоваться для этого игрового проекта. Если у вас уже есть идентификаторы клиентов OAuth2, вы можете выбрать один. Однако обычно вы создаете новый. Нажмите Создать клиент OAuth . Откроется диалоговое окно с глубокими ссылками и инструкциями по созданию идентификатора клиента OAuth в Google Cloud Platform.
- В качестве типа приложения выберите Android .
- Введите название вашей игры в поле «Название» .
- Введите имя пакета вашего приложения Android в поле Имя пакета .
Откройте терминал и запустите утилиту Keytool, чтобы получить отпечатки SHA1 сертификатов выпуска и отладки.
Чтобы получить отпечаток сертификата выпуска, выполните следующую команду:
keytool -list -keystore <path-to-production-keystore> -v
Чтобы получить отпечаток сертификата отладки, выполните следующую команду:
keytool -list -keystore <path-to-debug-keystore> -v
Утилита keytool предложит вам ввести пароль для хранилища ключей. Пароль по умолчанию для хранилища ключей отладки —
android
. Затем keytool печатает отпечаток пальца на терминале.Вставьте отпечаток SHA1 в поле «Отпечаток сертификата подписи» (SHA1) .
Нажмите Создать .
Дополнительные сведения об OAuth 2.0 на Android см. в разделе Аутентификация в службах OAuth2 .
После того, как вы нажмете «Готово» в диалоговом окне, доступные идентификаторы клиентов обновятся. Выберите созданные вами учетные данные в раскрывающемся меню и нажмите «Сохранить изменения» . При этом учетные данные будут созданы в виде черновика, что позволит вам пройти аутентификацию в игровых сервисах Play в вашей игре.
Возможно, вы захотите создать два учетных данных: один с отпечатком сертификата выпуска и один с отпечатком сертификата отладки. Обязательно используйте одно и то же имя пакета для обоих. Это позволяет игровым сервисам Google Play распознавать вызовы из связанных APK-файлов, подписанных любым сертификатом. Дополнительные сведения о подписании сертификата для Android см. в разделе Подписание приложения .
Игровой сервер
Настройка учетных данных
Убедитесь, что имя в поле «Имя» соответствует названию вашей игры.
Настроить авторизацию
Затем выберите идентификатор клиента OAuth, который будет использоваться для этого игрового проекта. Если у вас уже есть идентификаторы клиентов OAuth2, вы можете выбрать один. Однако обычно вы создаете новый. Нажмите Создать клиент OAuth . Откроется диалоговое окно с глубокими ссылками и инструкциями по созданию идентификатора клиента OAuth в Google Cloud Platform.
- Выберите Веб-приложение в качестве типа приложения.
- Введите название вашей игры в поле «Название» .
- Нажмите Создать .
Дополнительные сведения об OAuth 2.0 на Android см. в разделе Аутентификация в службах OAuth2 .
После того, как вы нажмете «Готово» в диалоговом окне, доступные идентификаторы клиентов обновятся. Выберите созданные вами учетные данные в раскрывающемся меню и нажмите «Сохранить изменения» . При этом учетные данные будут созданы в виде черновика, что позволит вам пройти аутентификацию в игровых сервисах Play с вашего игрового сервера. Дополнительную информацию об использовании игровых сервисов Play с вашим игровым сервером см. в разделе «Включение серверного доступа к игровым сервисам Google Play» .
Включить тестирование
Чтобы убедиться, что игровые сервисы Google Play корректно работают в вашей игре, вам следует протестировать свои игровые сервисы перед публикацией изменений в игре в Google Play.
Если ваша игра находится в неопубликованном состоянии, предоставьте доступ своим тестировщикам, добавив их учетные записи в белый список. В противном случае ваши тестировщики столкнутся с ошибками OAuth и 404 при попытке доступа к конечным точкам игровых сервисов Play, например к конечной точке входа.
Пользователи с авторизованными тестовыми учетными записями получат доступ к вашему неопубликованному игровому проекту Play Games Services и смогут проверить правильность работы настроенных вами игровых сервисов Play.
Есть два способа разрешить тестировщикам использовать API игровых сервисов Play для вашей игры:
На индивидуальном уровне путем добавления отдельных адресов электронной почты.
На уровне группы, включив игровые сервисы Play для версии версии Play Console.
Чтобы добавить отдельных тестировщиков в свой игровой проект:
- Откройте вкладку «Тестеры» для своей игры в консоли Google Play ( Grow > Play Games Services > Настройка и управление > Тестеры ).
- Нажмите кнопку Добавить тестировщиков .
- В появившемся диалоговом окне введите адреса электронной почты учетных записей Google, которые вы хотите добавить в качестве тестировщиков (через запятую или по одному адресу электронной почты в каждой строке).
- Нажмите «Добавить» , чтобы сохранить пользователей в качестве тестировщиков. Добавленные вами тестовые учетные записи должны получить доступ к игровым сервисам Play в течение нескольких часов.
Чтобы предоставить группе доступ для тестирования, включите версию выпуска для доступа к игровым сервисам Play:
Google Play позволяет легко распространять предварительные версии вашего приложения среди контролируемых групп доверенных пользователей с помощью функции отслеживания выпуска. См. раздел «Настройка открытого, закрытого или внутреннего теста» на справочном сайте Google Play.
Вы можете предоставить доступ для тестирования вашей игры всем пользователям, у которых есть доступ к тестовым APK-файлам определенной версии выпуска. Это работает так же, как если бы вы добавили их в список тестеров по отдельности. Для этого выполните следующие действия:
- Откройте раздел «Тестеры PGS» ( Grow > Play Games Services > Настройка и управление > Тестеры ) и выберите вкладку «Дорожки выпуска» . На этой странице вы также можете увидеть список треков, которые уже включены для тестирования Play Games Services.
- Нажмите Добавить треки .
- Выберите одну или несколько дорожек для тестирования игровых сервисов Play.
- Нажмите «Добавить треки» .
Выбранные треки выпуска теперь появятся в списке треков, включенных для тестирования Play Games Services.
Эта функция доступна только в том случае, если у вас есть приложение Android, связанное с вашей игрой в консоли Google Play.
Избегайте распространенных проблем
Чтобы избежать распространенных ошибок при настройке, обязательно следуйте этим рекомендациям при настройке игры для использования игровых сервисов Google Play.
- 1. Настройте игру с помощью Play Console.
- Если вы создали идентификатор клиента Oauth 2.0 для своего приложения в Google Cloud Console, игровые сервисы Google Play не будут знать о связи между игровыми достижениями и списками лидеров и идентификатором клиента. Чтобы создать эту ассоциацию, необходимо создать учетные данные, используя идентификатор клиента Oauth 2.0, как описано в разделе Создание учетных данных .
- 2. Используйте правильный идентификатор приложения в Android.
- Идентификатор приложения — это обязательный строковый ресурс, на который вы должны ссылаться в манифесте Android. Строка идентификатора приложения состоит только из цифр (обычно 12 или более) в начале идентификатора клиента, предоставленного Play Console. Идентификатор приложения можно найти в верхней части страницы конфигурации . Он помечен как «Идентификатор проекта» под названием вашей игры.
- 3. Подпишите APK правильным сертификатом.
- При связывании приложения Android с игрой в Play Console вы должны использовать точно такое же имя пакета и отпечаток сертификата, которые вы использовали для публикации приложения. В случае несоответствия вызовы игровых сервисов Google Play завершится неудачно. Вам следует создать два идентификатора клиента: один с отпечатком сертификата выпуска, а другой с отпечатком сертификата отладки, и использовать для обоих одно и то же имя пакета. Дополнительные сведения о том, как указать сертификат подписи в Play Console, см. в разделе «Подписание приложений» .
- 4. При разработке для Android включайте Play Games SDK как проект библиотеки, а не как отдельный JAR-файл.
- Убедитесь, что SDK Служб Google Play указан как проект библиотеки в вашем проекте Android, иначе это может привести к ошибкам, когда ваше приложение не сможет найти ресурсы Служб Google Play. Чтобы узнать, как настроить проект Android для использования сервисов Google Play, см. раздел Настройка сервисов Google Play .
- 5. Войдите в систему с учетной записью тестера во время разработки.
- Если вы не опубликовали изменения настроек игры в Play Console, во время тестирования могут возникнуть ошибки, если вы не вошли в систему с учетной записью тестировщика из белого списка. Вам всегда следует включать свою учетную запись издателя Play Console для тестирования. Чтобы узнать, как управлять учетными записями тестировщиков, см. Включение учетных записей для тестирования .
- 6. Опубликуйте экран согласия в Google Cloud Platform.
- Прежде чем публиковать приложение в Play Console, опубликуйте экран согласия в Google Cloud Platform. Без этого шага публичная аудитория не сможет использовать ни одну из функций игровых сервисов Play.
- 7. При выпуске опубликуйте настройки игровых сервисов Play, прежде чем публиковать игру.
- Разработчики могут случайно опубликовать свое приложение, не опубликовав соответствующие настройки игровых сервисов Play для своего приложения. Это может привести к тому, что игроки, которые входят в систему с учетными записями, не являющимися тестировщиками, могут столкнуться с ошибками, поскольку приложение не может ссылаться на правильные настройки игры. При выпуске игры не забудьте сначала опубликовать настройки игры, используя опцию «Опубликовать игру» в Play Console. Чтобы узнать, как опубликовать изменения, см. Публикация изменений в игре .
Дополнительные советы см. в руководстве по устранению неполадок Android .
Следующие шаги
Выполнив описанные выше первоначальные задачи по настройке, вы сможете включить для своей игры функции игровых сервисов Play , такие как сохраненные игры, списки лидеров и достижения.
,На этой странице описано, как настроить игровые сервисы Google Play для вашей игры Android с помощью консоли Google Play. Play Console предоставляет вам централизованное место для управления игровыми сервисами и настройки метаданных, используемых для авторизации и аутентификации вашей игры.
Чтобы добавить игру в Play Console, выполните следующие общие действия:
Создайте игровой проект для своей игры и укажите такие детали, как название и описание игры.
Создайте и свяжите необходимые учетные данные для авторизации и аутентификации вашей игры в игровых сервисах Google Play.
Прежде чем начать
Прежде чем настраивать игровые сервисы Google Play, выполните следующие действия.
Создайте учетную запись разработчика Google Play.
У вас должна быть учетная запись разработчика Google Play, настроенная в Play Console. Дополнительную информацию см. в разделе Регистрация учетной записи разработчика Google Play .
Предоставьте разрешение на редактирование. Чтобы редактировать настройки игровых сервисов Play в Play Console, у вашей команды должны быть разрешения на управление игровыми сервисами Play. Дополнительные сведения см. в разделе Добавление пользователей учетной записи разработчика и управление разрешениями .
Создайте проект Google Cloud
У вас должен быть настроен проект Google Cloud. Для получения дополнительной информации см.
Войдите в Play Console
Для входа перейдите в консоль Google Play . Если вы ранее не регистрировались в Play Console, вам будет предложено это сделать.
Добавьте свою игру в Play Console
Чтобы добавить свою игру, выполните следующие действия:
В Play Console создайте приложение и укажите, что это игра. Дополнительные сведения см. в разделе Создание и настройка приложения .
Перейдите в раздел «Grow» > «Play Games Services» > «Настройка и управление» > «Конфигурация» .
Укажите, использует ли ваша игра API Google (например, Firebase). Важно, чтобы вы выбрали правильный вариант; в противном случае в вашей игре могут возникнуть проблемы при использовании API Google. Вот варианты:
Нет, моя игра не использует API Google . Если вы создаете новую игру или никогда не настраивали для нее API Google, выберите этот вариант. Введите название вашей игры и нажмите «Создать» .
Да, моя игра уже использует API Google . Выберите этот вариант, если вы уже настроили API Google для игры. В этом случае вы увидите список своих проектов в Google Cloud Console. Выберите свой проект из списка и нажмите « Использовать» .
Использовать существующий проект игровых сервисов Play . Если вы хотите использовать существующий проект игровых сервисов Play, выберите этот вариант. Вы увидите список существующих проектов игровых сервисов Play для вашей учетной записи. Выберите свой игровой проект из списка и нажмите «Использовать» . Это нетипичный выбор, но вы можете сделать это, если создаете новую игру в Play Console, чтобы изменить имя пакета, или если у вас есть бесплатная и платная версии игры с разными именами пакетов.
Создается игровой проект Play Games Services, и для вас создается соответствующая запись в Google Cloud Console .
В разделе «Свойства» нажмите «Изменить свойства», чтобы добавить такую информацию, как описание, категория и графические ресурсы для вашей игры. Вот несколько рекомендаций по настройке свойств:
Для тестирования требуется только отображаемое имя. Остальные поля необходимо заполнить, прежде чем вы сможете опубликовать свою игру.
Отображаемое имя и описание вашей игры должны совпадать с тем, что вы указали в ее списке Play Store.
Рекомендации по созданию графических ресурсов см. в разделах «Добавление ресурсов предварительного просмотра для демонстрации вашего приложения» и «Рекомендации Google Play по избранным изображениям» .
Создайте идентификатор клиента 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 игровых сервисов Play) или учетные данные игрового сервера (если ваш игровой сервер будет использовать API игровых сервисов Play). Следуйте инструкциям, соответствующим желаемому типу учетных данных.
Андроид
Настройка учетных данных
Убедитесь, что имя в поле «Имя» соответствует названию вашей игры. Выберите, включать ли защиту от пиратства .
Настроить авторизацию
Затем выберите идентификатор клиента OAuth, который будет использоваться для этого игрового проекта. Если у вас уже есть идентификаторы клиентов OAuth2, вы можете выбрать один. Однако обычно вы создаете новый. Нажмите Создать клиент OAuth . Откроется диалоговое окно с глубокими ссылками и инструкциями по созданию идентификатора клиента OAuth в Google Cloud Platform.
- В качестве типа приложения выберите Android .
- Введите название вашей игры в поле «Название» .
- Введите имя пакета вашего приложения Android в поле Имя пакета .
Откройте терминал и запустите утилиту Keytool, чтобы получить отпечатки SHA1 сертификатов выпуска и отладки.
Чтобы получить отпечаток сертификата выпуска, выполните следующую команду:
keytool -list -keystore <path-to-production-keystore> -v
Чтобы получить отпечаток сертификата отладки, выполните следующую команду:
keytool -list -keystore <path-to-debug-keystore> -v
Утилита keytool предложит вам ввести пароль для хранилища ключей. Пароль по умолчанию для хранилища ключей отладки —
android
. Затем keytool печатает отпечаток пальца на терминале.Вставьте отпечаток SHA1 в поле «Отпечаток сертификата подписи» (SHA1) .
Нажмите Создать .
Дополнительные сведения об OAuth 2.0 на Android см. в разделе Аутентификация в службах OAuth2 .
После того, как вы нажмете «Готово» в диалоговом окне, доступные идентификаторы клиентов обновятся. Выберите созданные вами учетные данные в раскрывающемся меню и нажмите «Сохранить изменения» . При этом учетные данные будут созданы в виде черновика, что позволит вам пройти аутентификацию в игровых сервисах Play в вашей игре.
Возможно, вы захотите создать два учетных данных: один с отпечатком сертификата выпуска и один с отпечатком сертификата отладки. Обязательно используйте одно и то же имя пакета для обоих. Это позволяет игровым сервисам Google Play распознавать вызовы из связанных APK-файлов, подписанных любым сертификатом. Дополнительные сведения о подписании сертификата для Android см. в разделе Подписание приложения .
Игровой сервер
Настройка учетных данных
Убедитесь, что имя в поле «Имя» соответствует названию вашей игры.
Настроить авторизацию
Затем выберите идентификатор клиента OAuth, который будет использоваться для этого игрового проекта. Если у вас уже есть идентификаторы клиентов OAuth2, вы можете выбрать один. Однако обычно вы создаете новый. Нажмите Создать клиент OAuth . Откроется диалоговое окно с глубокими ссылками и инструкциями по созданию идентификатора клиента OAuth в Google Cloud Platform.
- Выберите Веб-приложение в качестве типа приложения.
- Введите название вашей игры в поле «Название» .
- Нажмите Создать .
Дополнительные сведения об OAuth 2.0 на Android см. в разделе Аутентификация в службах OAuth2 .
После того, как вы нажмете «Готово» в диалоговом окне, доступные идентификаторы клиентов обновятся. Выберите созданные вами учетные данные в раскрывающемся меню и нажмите «Сохранить изменения» . При этом учетные данные будут созданы в виде черновика, что позволит вам пройти аутентификацию в игровых сервисах Play с вашего игрового сервера. Дополнительную информацию об использовании игровых сервисов Play с вашим игровым сервером см. в разделе «Включение серверного доступа к игровым сервисам Google Play» .
Включить тестирование
Чтобы убедиться, что игровые сервисы Google Play корректно работают в вашей игре, вам следует протестировать свои игровые сервисы перед публикацией изменений в игре в Google Play.
Если ваша игра находится в неопубликованном состоянии, предоставьте доступ своим тестировщикам, добавив их учетные записи в белый список. В противном случае ваши тестировщики столкнутся с ошибками OAuth и 404 при попытке доступа к конечным точкам игровых сервисов Play, например к конечной точке входа.
Пользователи с авторизованными тестовыми учетными записями получат доступ к вашему неопубликованному игровому проекту Play Games Services и смогут проверить правильность работы настроенных вами игровых сервисов Play.
Есть два способа разрешить тестировщикам использовать API игровых сервисов Play для вашей игры:
На индивидуальном уровне путем добавления отдельных адресов электронной почты.
На уровне группы, включив игровые сервисы Play для версии версии Play Console.
Чтобы добавить отдельных тестировщиков в свой игровой проект:
- Откройте вкладку «Тестеры» для своей игры в консоли Google Play ( Grow > Play Games Services > Настройка и управление > Тестеры ).
- Нажмите кнопку Добавить тестировщиков .
- В появившемся диалоговом окне введите адреса электронной почты учетных записей Google, которые вы хотите добавить в качестве тестировщиков (через запятую или по одному адресу электронной почты в каждой строке).
- Нажмите «Добавить» , чтобы сохранить пользователей в качестве тестировщиков. Добавленные вами тестовые учетные записи должны получить доступ к игровым сервисам Play в течение нескольких часов.
Чтобы предоставить группе доступ для тестирования, включите версию выпуска для доступа к игровым сервисам Play:
Google Play позволяет легко распространять предварительные версии вашего приложения среди контролируемых групп доверенных пользователей с помощью функции отслеживания выпуска. См. раздел «Настройка открытого, закрытого или внутреннего теста» на справочном сайте Google Play.
Вы можете предоставить доступ для тестирования вашей игры всем пользователям, у которых есть доступ к тестовым APK-файлам определенной версии выпуска. Это работает так же, как если бы вы добавили их в список тестеров по отдельности. Для этого выполните следующие действия:
- Откройте раздел «Тестеры PGS» ( Grow > Play Games Services > Настройка и управление > Тестеры ) и выберите вкладку «Дорожки выпуска» . На этой странице вы также можете увидеть список треков, которые уже включены для тестирования Play Games Services.
- Нажмите Добавить треки .
- Выберите одну или несколько дорожек для тестирования игровых сервисов Play.
- Нажмите «Добавить треки» .
Выбранные треки выпуска теперь появятся в списке треков, включенных для тестирования Play Games Services.
Эта функция доступна только в том случае, если у вас есть приложение Android, связанное с вашей игрой в консоли Google Play.
Избегайте распространенных проблем
Чтобы избежать распространенных ошибок при настройке, обязательно следуйте этим рекомендациям при настройке игры для использования игровых сервисов Google Play.
- 1. Настройте игру с помощью Play Console.
- Если вы создали идентификатор клиента Oauth 2.0 для своего приложения в Google Cloud Console, игровые сервисы Google Play не будут знать о связи между игровыми достижениями и списками лидеров и идентификатором клиента. Чтобы создать эту ассоциацию, необходимо создать учетные данные, используя идентификатор клиента Oauth 2.0, как описано в разделе Создание учетных данных .
- 2. Используйте правильный идентификатор приложения в Android.
- Идентификатор приложения — это обязательный строковый ресурс, на который вы должны ссылаться в манифесте Android. Строка идентификатора приложения состоит только из цифр (обычно 12 или более) в начале идентификатора клиента, предоставленного Play Console. Идентификатор приложения можно найти в верхней части страницы конфигурации . Он помечен как «Идентификатор проекта» под названием вашей игры.
- 3. Подпишите APK правильным сертификатом.
- При связывании приложения Android с игрой в Play Console вы должны использовать точно такое же имя пакета и отпечаток сертификата, которые вы использовали для публикации приложения. В случае несоответствия вызовы игровых сервисов Google Play завершится неудачей. Вам следует создать два идентификатора клиента: один с отпечатком сертификата выпуска, а другой с отпечатком сертификата отладки, и использовать для обоих одно и то же имя пакета. Дополнительные сведения о том, как указать сертификат подписи в Play Console, см. в разделе «Подписание приложений» .
- 4. При разработке для Android включайте Play Games SDK как проект библиотеки, а не как отдельный JAR-файл.
- Убедитесь, что SDK Google Play Services указан как проект библиотеки в вашем проекте Android, иначе это может привести к ошибкам, когда ваше приложение не сможет найти ресурсы Google Play Services. Чтобы узнать, как настроить проект Android для использования сервисов Google Play, см. раздел Настройка сервисов Google Play .
- 5. Войдите в систему с учетной записью тестера во время разработки.
- Если вы не опубликовали изменения настроек игры в Play Console, во время тестирования могут возникнуть ошибки, если вы не вошли в систему с учетной записью тестировщика из белого списка. Вам всегда следует включать свою учетную запись издателя Play Console для тестирования. Чтобы узнать, как управлять учетными записями тестировщиков, см. Включение учетных записей для тестирования .
- 6. Опубликуйте экран согласия в Google Cloud Platform.
- Прежде чем публиковать приложение в Play Console, опубликуйте экран согласия в Google Cloud Platform. Без этого шага публичная аудитория не сможет использовать ни одну из функций игровых сервисов Play.
- 7. При выпуске опубликуйте настройки игровых сервисов Play, прежде чем публиковать игру.
- Разработчики могут случайно опубликовать свое приложение, не опубликовав соответствующие настройки игровых сервисов Play для своего приложения. Это может привести к тому, что игроки, которые входят в систему с учетными записями, не являющимися тестировщиками, могут столкнуться с ошибками, поскольку приложение не может ссылаться на правильные настройки игры. При выпуске игры не забудьте сначала опубликовать настройки игры, используя опцию «Опубликовать игру» в Play Console. Чтобы узнать, как опубликовать изменения, см. Публикация изменений в игре .
Дополнительные советы см. в руководстве по устранению неполадок Android .
Следующие шаги
После выполнения описанных выше задач первоначальной настройки вы сможете включить в своей игре функции игровых сервисов Play , такие как сохраненные игры, списки лидеров и достижения.
,На этой странице описано, как настроить игровые сервисы Google Play для вашей игры Android с помощью консоли Google Play. Play Console предоставляет вам централизованное место для управления игровыми сервисами и настройки метаданных, используемых для авторизации и аутентификации вашей игры.
Чтобы добавить игру в Play Console, выполните следующие общие действия:
Создайте игровой проект для своей игры и укажите такие детали, как название и описание игры.
Создайте и свяжите необходимые учетные данные для авторизации и аутентификации вашей игры в игровых сервисах Google Play.
Прежде чем начать
Прежде чем настраивать игровые сервисы Google Play, выполните следующие действия.
Создайте учетную запись разработчика Google Play.
У вас должна быть учетная запись разработчика Google Play, настроенная в Play Console. Дополнительную информацию см. в разделе Регистрация учетной записи разработчика Google Play .
Предоставьте разрешение на редактирование. Чтобы редактировать настройки игровых сервисов Play в Play Console, у вашей команды должны быть разрешения на управление игровыми сервисами Play. Дополнительные сведения см. в разделе Добавление пользователей учетной записи разработчика и управление разрешениями .
Создайте проект Google Cloud
У вас должен быть настроен проект Google Cloud. Для получения дополнительной информации см.
Войдите в Play Console
Для входа перейдите в консоль Google Play . Если вы ранее не регистрировались в Play Console, вам будет предложено это сделать.
Добавьте свою игру в Play Console
Чтобы добавить свою игру, выполните следующие действия:
В Play Console создайте приложение и укажите, что это игра. Дополнительные сведения см. в разделе Создание и настройка приложения .
Перейдите в раздел «Grow» > «Play Games Services» > «Настройка и управление» > «Конфигурация» .
Укажите, использует ли ваша игра API Google (например, Firebase). Важно, чтобы вы выбрали правильный вариант; в противном случае в вашей игре могут возникнуть проблемы при использовании API Google. Вот варианты:
Нет, моя игра не использует API Google . Если вы создаете новую игру или никогда не настраивали для нее API Google, выберите этот вариант. Введите имя вашей игры, а затем нажмите «Создать» .
Да, моя игра уже использует Google API : выберите эту опцию, если вы уже настроили API Google для игры. Если это так, вы увидите список ваших проектов от Google Cloud Console. Выберите свой проект из списка, а затем нажмите «Использовать» .
Используйте существующий проект Play Games Services : если вы хотите использовать существующий проект Play Games Services, выберите эту опцию. Вы увидите список существующих проектов служб игры для игр для вашей учетной записи. Выберите свой игровой проект из списка, а затем нажмите «Использовать» . Это не типичный выбор, но вы можете сделать это, если вы создаете новую игру в Play Console, чтобы изменить имя пакета, или если у вас есть бесплатные и платные версии вашей игры с разными именами пакетов.
Создан игровой проект Games Services Games, и в Cloud Console создается соответствующая запись.
В разделе «Свойства» нажмите «Редактировать свойства» , чтобы добавить информацию, такую как описание, категория и графические активы для вашей игры. Вот некоторые рекомендации по созданию свойств:
Для тестирования требуется только имя отображения. Другие поля должны быть заполнены, прежде чем вы сможете опубликовать свою игру.
Название отображения и описание для вашей игры должны соответствовать тому, что вы настроили в списке магазина игры в игре.
Рекомендации по созданию графических активов см. В Add Preview Assets, чтобы продемонстрировать ваше приложение и Google Play Please-Image Ruders .
Создать идентификатор клиента OAuth 2.0
Ваша игра должна иметь идентификатор клиента OAuth 2.0, чтобы быть аутентифицированной и авторизованной, чтобы позвонить в Google Play Games Services. Чтобы настроить учетные данные для Spear Games Services, которая является ассоциацией между идентификатором клиента и вашей игрой, используйте Google Cloud Platform для создания идентификатора клиента. Затем используйте Google Play Console, чтобы добавить учетные данные, связывая идентификатор клиента с вашей игрой.
Для получения более подробных инструкций см. Следующие шаги:
Настройте экран согласия OAuth
Если вы еще не настроили экран согласия OAuth, в разделе учетных данных отобразится сообщение, которое предлагает вам настроить.
Нажмите «Настроить» . Это открывает диалог с дополнительными инструкциями и глубокой ссылкой на облачную платформу Google.
Убедитесь, что экран согласия доступен всем, для чего игра доступна. Окончательный список областей должен включать games
, games_lite
и drive.appdata
; Ни одна из этих областей не потребует проверки приложений. Мы рекомендуем немедленно опубликовать экран согласия. Если это невозможно, вы можете сделать экран согласия доступным для тестеров, чтобы они могли входить в игру.
Если вы завершили настройку экрана согласия OAuth, нажмите «Готово» . Google Play Console освещает автоматически, и если конфигурация была успешной, вы сможете создать учетные данные:
Создать учетные данные
Чтобы разрешить свою игру для общения с Google Play Services, вы должны создать учетные данные с авторизованным идентификатором клиента OAuth2.
В разделе учетных данных нажмите «Добавить учетные данные» .
В мастере выберите, хотите ли вы создать учетные данные для Android (если ваша игра APK будет аутентифицировать пользователя и использовать API Play Games Services) или учетные данные сервера игрового сервера (если ваш игровой сервер будет использовать API Shay Games Services). Следуйте инструкциям, специфичным для вашего желаемого типа учетных данных.
Андроид
Установите подробности учетных данных
Убедитесь, что имя в поле «Имя» соответствует названию вашей игры. Выберите, включить ли антипиратство .
Настройка авторизации
Затем выберите идентификатор клиента OAuth для использования для этого игрового проекта. Если у вас уже есть идентификаторы клиентов OAuth2, вы можете выбрать его. Тем не менее, вы обычно создаете новый. Нажмите «Создать клиент OAuth» . Это открывает диалог с глубокими ссылками и инструкциями для создания идентификатора клиента OAuth в платформе Google Cloud.
- Выберите Android как тип приложения.
- Введите имя вашей игры в поле «Имя» .
- Введите имя пакета вашего приложения Android в поле «Имя пакета» .
Откройте терминал и запустите утилиту Keytool , чтобы получить отпечатки пальцев SHA1 от сертификатов релиза и отладки.
Чтобы получить отпечаток пальца сертификата выпуска, запустите следующую команду:
keytool -list -keystore <path-to-production-keystore> -v
Чтобы получить отпечаток пальца от отладка, запустите следующую команду:
keytool -list -keystore <path-to-debug-keystore> -v
Утилита KeyTool предлагает вам ввести пароль для хранилища ключей. Пароль по умолчанию для магазина ключей отладки -
android
. Затем ключевая клавиша печатает отпечаток пальца на терминал.Вставьте отпечаток пальца SHA1 в поле «Отпечаток отпечатков пальцев» (SHA1) .
Нажмите «Создать» .
Для получения дополнительной информации о OAuth 2.0 на Android см. Authenticating в Services OAuth2 .
После того, как вы нажимаете на DIDE в диалоговом окне, доступные идентификаторы клиента будут обновляться. Выберите учетные данные, которые вы создали в раскрывающемся меню, а затем нажмите «Сохранить изменения» . Это создает учетные данные как черновик, позволяя вам аутентифицировать подлинность для воспроизведения игровых услуг в вашей игре.
Возможно, вы захотите создать два учетных данных: один с отпечатком пальца в сертификате выпуска, а один - от отпечатка отпечатка пальца отладки. Обязательно используйте одно и то же имя пакета для обоих. Это позволяет Google Play Games Services распознавать звонки из ваших связанных APK, которые подписаны с любым сертификатом. Для получения дополнительной информации о подписании сертификата для Android см . Приложение .
Игровой сервер
Установите подробности учетных данных
Убедитесь, что имя в поле «Имя» соответствует названию вашей игры.
Настройка авторизации
Затем выберите идентификатор клиента OAuth для использования для этого игрового проекта. Если у вас уже есть идентификаторы клиентов OAuth2, вы можете выбрать его. Тем не менее, вы обычно создаете новый. Нажмите «Создать клиент OAuth» . Это открывает диалог с глубокими ссылками и инструкциями для создания идентификатора клиента OAuth в платформе Google Cloud.
- Выберите веб -приложение в качестве типа приложения.
- Введите имя вашей игры в поле «Имя» .
- Нажмите «Создать» .
Для получения дополнительной информации о OAuth 2.0 на Android см. Authenticating в Services OAuth2 .
После того, как вы нажимаете на DIDE в диалоговом окне, доступные идентификаторы клиента будут обновляться. Выберите учетные данные, которые вы создали в раскрывающемся меню, а затем нажмите «Сохранить изменения» . Это создает учетные данные как черновик, позволяя вам аутентифицировать подлинность для воспроизведения игровых сервисов с вашего игрового сервера. Для получения дополнительной информации об использовании игровых услуг с вашим игровым сервером см. Включение доступа на стороне сервера к Google Play Games Services .
Включить тестирование
Чтобы гарантировать, что Google Play Games Services правильно функционирует в вашей игре, вы должны протестировать свои игровые службы, прежде чем публиковать изменения в игре в Google Play.
Если ваша игра находится в неопубликованном состоянии, предоставьте доступ к вашим тестировщикам, добавив свои учетные записи пользователей в AlluctList. В противном случае ваши тестеры столкнутся с OAuth и 404 ошибками при попытке получить доступ к конечным точкам Service Services Services, такие как конечная точка входа.
Пользователи с авторизованными тестовыми учетными записями будут иметь доступ к вашему неопубликованному игровому проекту Play Games Services и могут проверить, что ваши настроенные игровые игровые службы работают правильно.
Есть два способа, чтобы тестеры использовали API -API Play Games Services для вашей игры:
На индивидуальном уровне, добавив отдельные адреса электронной почты.
На групповом уровне, предоставив Slay Games Services для трека выпуска Play Console.
Чтобы добавить отдельные тестеры в ваш игровой проект:
- Откройте вкладку Testers для вашей игры в консоли Google Play ( Grow > Play Games Services > Setup and Management > Testers ).
- Нажмите кнопку «Добавить тестеров» .
- В появившемся диалоговом окне введите адреса электронной почты учетных записей Google, которые вы хотите добавить в качестве тестеров (разделенных с запятыми или одним адресом электронной почты на строку).
- Нажмите «Добавить» , чтобы сохранить пользователей в качестве тестеров. Добавленные вами учетные записи, которые вы добавили, должны иметь возможность получить доступ к игровым услугам в течение нескольких часов.
Чтобы дать тестирование доступа к группе, включите трек релиза, чтобы получить доступ к игровым услугам:
Google Play позволяет легко распространять предварительные версии вашего приложения для контролируемых групп доверенных пользователей с функциями трека. См. Настройте открытый, закрытый или внутренний тест на веб -сайте Google Play Help.
Вы можете предоставить доступ для проверки вашей игры всем пользователям, которые имеют доступ к тестированию APK на данном треке. Это работает так же, как если бы вы добавили их в список тестеров индивидуально. Для этого следуйте этим шагам:
- Откройте раздел Testers PGS ( Grow > Play Games Services > Setup and Management > Testers ) и выберите вкладку Tracks Release . На этой странице вы также можете увидеть список треков, которые уже включены для тестирования услуг Play Games.
- Нажмите «Добавить треки» .
- Выберите один или несколько треков, чтобы включить для тестирования Spelay Games Services.
- Нажмите «Добавить треки» .
Выбранные треки выпуска теперь появятся в списке треков, включенных для тестирования служб игры.
Эта функция доступна только в том случае, если у вас есть приложение Android, связанное с вашей игрой в консоли Google Play.
Избегайте общих проблем
Чтобы избежать общих ошибок настройки, обязательно следуйте этим рекомендациям при настройке игры для использования Google Play Games Services.
- 1. Настройте свою игру с помощью игровой консоли
- Если вы создали идентификатор клиента OAuth 2.0 для вашего приложения в Cloud Console Google, службы Google Play Games не узнают об ассоциации между достижением игры и таблицами лидеров и идентификатором клиента. Чтобы создать эту ассоциацию, вы должны создать учетные данные, используя идентификатор клиента OAuth 2.0, как описано в создании учетных данных .
- 2. Используйте правильный идентификатор приложения в Android
- Идентификатор приложения - это необходимый ресурс строк, на который вы должны ссылаться в вашем манифесте Android. Строка идентификатора приложения состоит только из цифр (обычно 12 или более) в начале идентификатора клиента, предоставленного Play Console. Идентификатор приложения можно найти в верхней части страницы конфигурации и помечен как идентификатор проекта ниже названия вашей игры.
- 3. Подпишите свой APK с правильным сертификатом
- При связывании вашего приложения Android с вашей игрой в Play Console вы должны использовать точно такое же название пакета и отпечатки пальцев сертификата, которые вы использовали для публикации своего приложения. Если есть несоответствие, вызовы Google Play Services потерпят неудачу. Вы должны создать два идентификатора клиента, один с отпечатком Fingficate Service Servite, а другой - с отпечатком пальца отладки и использовать одно и то же имя пакета для обоих. Чтобы узнать больше о том, как указать сертификат подписания в игровой консоли, см. Подписание ваших приложений .
- 4. При разработке для Android включите Play Games SDK в качестве библиотечного проекта, а не как отдельная банка.
- Убедитесь, что SDK Google Play Services ссылается как библиотечный проект в вашем проекте Android, в противном случае это может привести к ошибкам, когда ваше приложение не может найти ресурсы Google Play Services. Чтобы узнать, как настроить свой Android Project для использования сервисов Google Play, см. Настройку Google Play Services .
- 5. Войдите с учетной записью тестера во время разработки
- Если вы не опубликовали изменения в настройке игры в игровой консоли, вы можете столкнуться с ошибками во время тестирования, если вы не подписали с учетной записью тестера в белом списке. Вы всегда должны включать свою учетную запись Play Console Publisher для тестирования. Чтобы узнать, как управлять учетными записями тестеров, см. Включение учетных записей для тестирования .
- 6. Опубликовать экран согласия на платформе Google Cloud
- Прежде чем публиковать приложение в Play Console, опубликуйте экран согласия в Google Cloud Platform. Без этого шага публичная аудитория не сможет использовать ни одну из функций игровых игр.
- 7. At Release опубликуйте настройки служб Play Games Services, прежде чем опубликовать свою игру
- Разработчики могут случайно опубликовать свое приложение, не опубликовав соответствующие настройки служб Play Games для своего приложения. Это может привести к тому, что игроки, которые вписались в неэтрысовые учетные записи, сталкиваться с ошибками, поскольку приложение не может ссылаться на правильные настройки игры. Выпустив свою игру, не забудьте сначала опубликовать настройки игры, используя опцию Publish Game в Play Console. Чтобы узнать, как опубликовать свои изменения, см. Публикацию ваших изменений в игре .
Для получения дополнительных советов см. Руководство по устранению неисправностей Android .
Следующие шаги
После того, как вы выполните первоначальные задачи настройки, описанные выше, вы сможете включить функции игровых услуг для своей игры, такие как сохраненные игры, списки лидеров и достижения.