Первый шаг при интеграции игры с сервисами Google Play Games (PGS) – это реализация аутентификации платформы. Это необходимо, чтобы получить доступ к другим функциям, таким как достижения, рейтинги игроков и события.
Поскольку SDK сервисов Play Games автоматически выполняет аутентификацию на платформе при запуске игры, вам нужно интегрировать SDK сервисов Play Games версии 2 в игру и реализовать рекомендуемый процесс аутентификации. Это позволит подготовить игру к внедрению правил в отношении удобства для пользователей, необходимых для участия в программе Level Up от Google Play Games.
Основные понятия аутентификации
В сервисах Play Games версии 2 концепция входа разделена на два отдельных уровня: аутентификация на платформе и аутентификация в игре.
Аутентификация платформы
Сервисы Play Игр предоставляют уровень взаимодействия с платформой. Он управляет взаимодействием игрока с экосистемой Google Play Games с помощью игрового профиля, чтобы получить доступ к таким функциям, как достижения, рейтинги игроков и квесты. Аутентификация платформы имеет следующие ключевые характеристики:
- Автоматическая аутентификация в фоновом режиме. Аутентификация выполняется автоматически в фоновом режиме при запуске игры. В сервисах Play Games не требуется кнопка Войти.
- Идентификатор игрока. После успешной аутентификации на платформе сервисы Play Games предоставляют стабильный идентификатор игрока. Этот идентификатор не меняется на разных устройствах для одной и той же игры. Используйте этот идентификатор в основном для отслеживания функций платформы, например прогресса в достижении.
- Независимость. Не используйте сервисы Play Games в качестве основной системы идентификации для управления аккаунтом игрока, его прогрессом или инвентарем. сервисы Play Games служат постоянным идентификатором платформы.
Псевдоним
Идентификатор игрока – это идентификатор аккаунта игрока в сервисах Play Games. Ваша игра может получить идентификатор игрока для любого игрока, который вошел в вашу игру с помощью аутентификации сервисов Play Games. Интеграция клиента игры, интеграция сервера игры и сервис сохранения в облаке могут использовать идентификатор для безопасного доступа к данным игрока из игровых сервисов Google Play.
Идентификатор игрока остается неизменным, когда пользователь играет в вашу игру на нескольких устройствах. Однако в разных играх он может отличаться. Подробнее об идентификаторах игроков нового поколения…
Аутентификация в игре
Вы управляете аккаунтом в игре, который представляет собой систему идентификации, связывающую прогресс игрока, инвентарь и валюту в вашей игре.
- Основной способ входа. Вы можете использовать собственный сервер, функцию "Войти с аккаунтом Google" или другие сервисы.
- Независимость. Игроки могут войти в сервисы Play Games (идентификатор платформы), чтобы получать достижения, и при этом использовать любой аккаунт для входа в игру (например, гостевой аккаунт или аккаунт Google).
- Управление несколькими аккаунтами в игре. Сервисы Play Games обрабатывают только аутентификацию на платформе. Ваша игра управляет основной аутентификацией игроков в их аккаунтах IGA. Это значит, что в игре не изменится процесс переключения между аккаунтами. Когда игроки переключаются между аккаунтами, они остаются аутентифицированными на платформе Play Игр через PGS, и вы продолжаете отправлять их данные, связанные с достижениями и другими функциями PGS, в соответствии с постоянным идентификатором игрока.
Межплатформенная непрерывность с помощью функции "Войти с аккаунтом Google"
Чтобы игроки могли сохранять прогресс на устройствах Android и iOS, а также в веб-версии, используйте функцию "Войти с аккаунтом Google" в качестве основного способа аутентификации в игре. Учитывайте следующее:
- Кнопка "Войти с аккаунтом Google". В PGS версии 1 кнопка Google Play часто использовалась для входа как на платформу, так и в игру. В версии 2 это отдельные процессы. Добавьте стандартную кнопку Войти с аккаунтом Google, чтобы игроки могли проходить аутентификацию и получать доступ к своему аккаунту IGA.
- SDK для входа с аккаунтом Google:
- Для аутентификации игроков в IGA используйте стандартные SDK Google Sign-In для Android и iOS.
- Используйте Google Open ID в качестве основного идентификатора для аккаунта игрока.
- Используйте идентификатор игрока в сервисах Play Games, чтобы сообщать о прогрессе игрока в функциях Play Игр, например о достижениях.
Рекомендуемая интеграция
Чтобы интегрировать игру с сервисами Play Games, выполните следующие рекомендуемые действия:
Инициализация и аутентификация
Этот шаг необходим для инициализации и аутентификации игры.
Реализуйте аутентификацию на платформе, инициализировав SDK сервисов Play Games версии 2 при запуске. Подробнее об аутентификации на платформе для игр Android… Это необходимо, чтобы получить доступ к функциям сервисов Play Games, таким как достижения и рейтинги игроков.
Аутентификация выполняется в фоновом режиме при запуске игры. Существующие пользователи сервисов Play Games увидят приветственное сообщение после успешной аутентификации. Пользователям, у которых нет профиля сервисов Play Games, будет предложено создать профиль во время инициализации SDK.

Создание профиля
Чтобы пользоваться платформой, игрокам нужен профиль сервисов Play Games. У некоторых игроков может не быть профиля сервисов Play Games, когда они запускают вашу игру. Им будет предложено создать его. Вы можете выбрать один из следующих вариантов:
Автоматически запускаемые подсказки по созданию профиля
Предложения создать профиль, запускаемые автоматически, по умолчанию появляются при запуске игры без профиля сервисов Play Games.
Как отключить автоматические предложения создать профиль
Отключите запросы профиля при запуске, настроив файл манифеста так, чтобы предотвратить автоматический запуск запросов. Это позволит пользователям без профиля сервисов Play Игр продолжать загружать игру без предложения создать профиль.
Хотя пользователи могут входить в аккаунт с помощью любого поставщика идентификационной информации, вы должны показывать им запрос на создание профиля, чтобы побудить их пройти аутентификацию на игровой платформе Play. Показывайте это предложение по мере необходимости, но обязательно до того, как пользователи достигнут значительного прогресса в таких функциях, как достижения и списки лидеров.
Рекомендуем показывать запрос профиля в следующие моменты:
- После завершения обучения.
- В момент получения награды (например, за победу в матче, получение редкого предмета или достижение цели).
- При запуске второго сеанса.
Подробнее о том, как запретить автоматическое создание профиля, рассказывается в статьях для Java и Unity.
Аутентификация в игре
После успешной аутентификации на платформе разработчикам следует выполнить следующие шаги, чтобы игроки могли получить доступ к своим аккаунтам Google Play Игр, в зависимости от текущего состояния игры:
- Если на устройстве есть активный игровой сеанс, разрешите игроку возобновить его.
- Если активного игрового сеанса нет:
- В случае бесшовного восстановления, когда последний аккаунт IGA связан с идентификатором игрока в PGS, автоматически восстановите связанный аккаунт IGA.
- В противном случае покажите игроку экран входа или создания аккаунта. Затем игроки могут выбрать предпочтительный способ аутентификации, чтобы создать аккаунт IGA или войти в существующий.
Области действия OAuth
Чтобы игроки могли предоставлять вашей игре доступ к своим аккаунтам, в сервисах Play Games используется система OAuth. У сервисов Play Games есть уникальная область действия для игр (games-lite). Если в вашей игре используется функция Сохраненных игр, то сервисы Play Games полагаются на другую область действия (drive.appdata). Функция "Сохраненные игры" предоставляет доступ к аккаунту Google Диска, где хранятся данные игры.
При использовании SDK сервисов Play Games версии 2 вы можете запрашивать дополнительные области действия OAuth.
Если вам нужны дополнительные области действия OAuth, рекомендуем вызвать requestServerSideAccess.
Подробнее о том, как получить код аутентификации сервера и как извлечь коды аутентификации сервера…
Рекомендации по удобству для пользователей при аутентификации
Ниже приведены рекомендации по аутентификации при интеграции PGS v2. Они охватывают сценарии для новых, существующих и вернувшихся пользователей, а также гостевой режим.
Новый игрок
Этот процесс применяется к пользователю, который впервые запускает игру на устройстве, где нет истории игры.
- При запуске SDK игровых сервисов Play инициализируется, чтобы выполнить аутентификацию идентификатора игрока на платформе (идентификатора игрока в игровых сервисах Play).
- После этого игра предлагает пользователю создать аккаунт, например выбрать вариант Создать аккаунт, Войти с аккаунтом Google или войти через социальную сеть.
- После того как игрок создаст или выберет IGA, игра свяжет этот аккаунт с выбранным основным идентификатором в серверной части.
- Игра также привязывает выбранный аккаунт iGA к идентификатору игрока PGS, помечая его как последний использованный аккаунт iGA для быстрого восстановления.
Игроки с активными сеансами
Этот сценарий описывает запуск игры на устройстве, на котором у пользователя уже есть активный сеанс. Цель состоит в том, чтобы обеспечить беспрепятственный вход.
- Когда пользователь запускает приложение, PGS выполняет аутентификацию в фоновом режиме и предоставляет вам идентификатор игрока, чтобы вы могли отслеживать его прогресс в достижениях и других функциях Play Игр.
- При этом, если возможно, игра пропускает экраны входа и сразу же выполняет вход в активный сеанс IGA или в последний сеанс IGA, связанный с идентификатором игрока, чтобы пользователь мог сразу продолжить игру.
Игроки, которые сменили аккаунт
Этот процесс происходит, когда игрок с активным сеансом переходит в настройки игры, чтобы сменить аккаунт. Например, выходить из основного аккаунта, чтобы использовать дополнительный.
- Игрок выходит из текущего аккаунта Google, но подключение к платформе игровых сервисов Google Play остается активным.
- Когда игрок входит в систему с другим аккаунтом IGA, игра привязывает этот новый аккаунт к текущему идентификатору игрока PGS как к последнему аккаунту IGA, с которым он играл, только для беспрепятственного восстановления.
Простое восстановление для вернувшихся игроков
Этот сценарий применяется, когда игрок запускает игру после периода неактивности, переустановки или на совершенно новом устройстве. Рекомендуем реализовать в игре бесшовное восстановление.
- При запуске PGS аутентифицирует пользователя и предоставляет игре его идентификатор.
- Игра проверяет свой бэкенд (или полученный токен переноса, если используется Recall API), чтобы узнать, связан ли последний использованный аккаунт IGA с этим идентификатором PGS.
- Если связь есть, игра автоматически восстанавливает прогресс игрока и выполняет вход, полностью пропуская экран входа вручную.
- В противном случае игра показывает пользователю экран входа.
- Затем игрок выбирает метод входа и входит в аккаунт IGA.
- Затем игра связывает этот аккаунт с идентификатором игрока в игровых сервисах Google Play как последний использованный аккаунт, чтобы обеспечить беспроблемное восстановление.
Гостевой режим
Игроки могут запускать вашу игру и играть в нее, используя локальный гостевой аккаунт. Сервисы Play Games по-прежнему выполняют аутентификацию игрока в фоновом режиме. Если игрок выбирает Сохранить прогресс, игра преобразует гостевой сеанс в постоянный аккаунт и связывает его с идентификатором игрока. Подробнее о гостевых аккаунтах…
Как протестировать игру
Протестируйте игру, чтобы убедиться, что она работает правильно. Тесты, которые вы проводите, зависят от функций вашей игры.
Ниже приведен список распространенных тестов.
Успешный вход.
Автоматический вход работает. При запуске игры пользователь должен входить в сервисы Play Games.
Появится всплывающее окно с приветствием.
Пример всплывающего окна с приветствием (нажмите, чтобы увеличить). Появятся сообщения в журнале об успешном выполнении. Выполните в терминале следующую команду:
adb logcat | grep com.google.android.
Ниже приведен пример сообщения в журнале об успешном выполнении:
[
$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup. [CONTEXT service_id=1 ]
Обеспечьте единообразие компонентов интерфейса.
Всплывающие окна, рейтинги игроков и достижения корректно и единообразно отображаются на экранах разного размера и с разной ориентацией в пользовательском интерфейсе сервисов Play Games.
В интерфейсе сервисов Play Games нет кнопки выхода.
Убедитесь, что вы можете получить идентификатор игрока и что серверные функции работают правильно.
Если в игре используется аутентификация на стороне сервера, тщательно протестируйте процесс
requestServerSideAccess. Убедитесь, что сервер получает код авторизации и может обменять его на токен доступа. Протестируйте успешные и неудачные сценарии для ошибок сети и недопустимых сценариевclient ID.
Если в вашей игре использовались какие-либо из перечисленных ниже функций, проверьте, работают ли они так же, как до переноса.
- Рейтинги. Отправляйте результаты и просматривайте рейтинги. Проверьте, правильно ли отображаются имена игроков, их результаты и места в рейтинге.
- Достижения. Разблокируйте достижения и убедитесь, что они правильно записываются и отображаются в интерфейсе Play Игр.
- Сохраненные игры. Если в игре есть функция сохранения, убедитесь, что она работает без сбоев. Это особенно важно протестировать на нескольких устройствах и после обновления приложения.