Настройте игровые сервисы Google 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. Для получения дополнительной информации см.

• Начните работу с Google Cloud
• Создание проекта

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

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

Войдите в Play Console

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

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

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

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

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

3. Укажите, использует ли ваша игра 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 .

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

   • Для тестирования требуется только отображаемое имя. Остальные поля необходимо заполнить, прежде чем вы сможете опубликовать свою игру.

   • Отображаемое имя и описание вашей игры должны совпадать с тем, что вы указали в ее списке 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). Следуйте инструкциям, соответствующим желаемому типу учетных данных.

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

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

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

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

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

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

• На уровне группы, включив игровые сервисы Play для версии версии Play Console.

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

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

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

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

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

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

Выбранные треки выпуска теперь появятся в списке треков, включенных для тестирования 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. Для получения дополнительной информации см.

• Начните работу с Google Cloud
• Создание проекта

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

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

Войдите в Play Console

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

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

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

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

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

3. Укажите, использует ли ваша игра 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 .

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

   • Для тестирования требуется только отображаемое имя. Остальные поля необходимо заполнить, прежде чем вы сможете опубликовать свою игру.

   • Отображаемое имя и описание вашей игры должны совпадать с тем, что вы указали в ее списке 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). Следуйте инструкциям, соответствующим желаемому типу учетных данных.

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

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

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

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

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

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

• На уровне группы, включив игровые сервисы Play для версии версии Play Console.

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

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

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

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

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

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

Выбранные треки выпуска теперь появятся в списке треков, включенных для тестирования 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 , такие как сохраненные игры, списки лидеров и достижения.